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This  user's  manual  describes  the  use  of  the  data  base  package  for  pie* 
zometer  data.  The  package  Is  a  product  of  the  Computer  Applications  In  Geo* 
technical  Engineering  (CAGE)  Project  of  the  Office,  Chief  of  Engineers  (OCE), 
US  Army  Corps  of  Engineers. 

Criteria  for  the  Piezometer  Data  Package  were  developed  by  the  CAGE  In* 

strumentatlon  Task  Group  composed  of  the  following  members: 

Hr.  Russ  Fondeller,  Chairman,  Ohio  River  Division 

Hr.  Marshall  Fausold,  Pittsburgh  District 

Mr.  Bernie  Hargrave,  Seattle  District 

Mr.  David  Lytle,  St.  Louis  District 

Mr.  Tom  Plummer,  Huntington  District 

Mr.  Steve  Stockton,  Portland  District 

Mr.  David  Wright,  Southwest  Division 

Mr.  Richard  Davidson,  OCE 

Mr.  Richard  Malm,  OCE 

Mr.  Earl  Edris,  Jr.,  Waterways  Experiment  Station  (WES) 

Mrs.  Wipawl  Vanad1t*E111s,  WES 

The  data  base  design  was  developed  by  Mr.  Earl  Edris,  Jr.,  Soil  Mechanics 
Division  (SMD),  Geotechnical  Laboratory  (6L),  WES,  project  engineer  for  the 
package,  and  Mrs.  Wipawl  Vanad1t*E111s,  SHD,  GL,  WES.  Software  was  developed 
by  Dr.  Darrell  Ward  and  Mr.  John  W.  Meux  through  the  North  Texas  State  Un1* 
versity  Computer  Science  Department.  The  data  entry  program  was  converted  for 
use  on  District  Harris  computers  by  Hr.  Jack  Cicone,  Automatic  Data  Processing 
Center,  Pittsburgh  District.  Graphics  programs  were  written  by  Messrs.  Larry 
Mann,  SMD,  GL,  Arden  P.  Park,  SMD,  John  Palmerton,  Engineering  Geology  and 
Rock  Mechanics  Division  (EGRMD),  GL,  and  Ms.  Mary  Jane  Gilmer,  EGRMD.  The 
initial  application  of  this  package  was  by  the  Pittsburgh  District.  Mr.  Tom 
Churilla,  Geotechnical  Branch,  Pittsburgh  District,  supervised  Messrs.  Paul 
Vandebunt  and  Kurt  Hallbert,  who  exercised  the  package  and  provided  valuable 
user  input  to  improve  the  programs.  This  report  was  prepared  by  Mr.  Edris 
and  Mrs.  Vanadit-Ellis. 

The  CAGE  project  principal  investigator  was  Mr.  William  E.  Strohm,  Jr. 
(EGRMD).  CAGE  project  work  is  directed  by  a  Policy  Management  Group  composed 
of  the  following:  Messrs.  Paul  Fisher,  Chief,  Geology  Section,  Geotechnical 
and  Civil  Branch  (GCB),  OCE  (DAEN-ECE-G),  Chairman;  Richard  Davidson,  Chief, 
Soil  Mechanics  Section,  GCB,  OCE:  Richard  Malm,  Chief,  Computation  and 


Analysis  Section,  Engineering  Support  Branch,  OCE  (DAEN-ECE-S) ;  Samuel 
Gillespie,  Engineer,  GCB,  OCE:  LeRoy  McAnear,  Chief,  SMD,  WES  Program 
Manager,  CW  R&D  Program,  Materials -Sol Is  (replaced  by  Mr.  David  P.  Hammer, 
Chief,  Geotechnical  Section,  Engineering  Division,  Ohio  River  Division  In 
June  1984);  Dr.  Don  C.  Banks,  Chief,  EGRND,  WES  Program  Manager,  CW  R&D 
Program,  Material s-Rock;  and  Mr.  Strohm,  Principal  Investigator,  CAGE.  This 
Investigation  was  carried  out  under  the  general  supervision  of  Dr.  William 
F.  Marcuson  III,  Chief,  GL.  This  report  was  edited  by  Ms.  Odell  F.  Allen, 
Publications  and  Graphic  Arts  Division. 

COL  Allen  F.  Grirni,  USA,  was  Director  of  WES.  Technical  Director 
was  Dr.  Robert  W.  Whalln. 
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CONVERSION  FACTORS,  NON-SI  TO  SI  (METRIC) 
UNITS  OF  MEASUREMENT 


Non-SI  units  of  measurement  used  in  this  manual  can  be  converted  to  SI  (metric) 
units  as  folloMs: 


Multipl' 


cubic  feet 
feet 

gallons  (US  liquid) 
inches 

pounds  (force)  per  square  inch 
pounds  (mass)  per  cubic  foot 


By  _ To  Obtain _ 

0.02831685  cubic  metres 

0,7645549  metres 

3.785412  cubic  decimetres 

0.3048  centimetres 

6.894757  kilopa seals 

16.01846  kilopascals  per  cubic  metre 
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PIEZOMETER  DATA  BASE  PACKAGE  USER*S  GUIDE 


PART  I:  INTRODUCTION 
Purpose 

1.  This  report  provides  a  description  and  Instructions  for  use  of  the 
piezometer  data  base  package  developed  by  the  Computer  Applications  In  Geo¬ 
technical  Engineering  (CAGE)  project.  The  report  Is  written  for  the  piezome¬ 
ter  data  base  user  and  Is  not  Intended  to  replace  the  computer  operating 
system  or  the  Intel  (System  2000)  data  base  user's  manual. 

Basic  Definl t1 ons 
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2.  A  data  base  Is  defined  as  pieces  or  groups  of  data  stored  together  In 
an  orderly  form  such  that  access  to  all  or  any  part  of  the  data  can  be  readily 
accomplished.  Data  manually  stored  In  a  filing  cabinet  could  be  classified  as 
a  simple  form  of  a  data  base.  A  computerized  data  base  Is  one  that  utilizes  a 
computer  and  associated  hardware  for  data  entry*  storage*  and  access.  A  data 
base  system  Includes*  In  addition  to  the  data  base  Itself*  all  peripheral 
software  that  enables  the  data  not  only  to  be  quickly  and  orderly  stored*  but 
also  accessed  In  any  form  desired  and  manipulated  or  analyzed  by  whatever 
means  are  most  useful  to  the  user.  A  data  base  system  can  therefore  be  cate¬ 
gorized  as  an  engineering  tool.  It  can*  If  properly  utilized*  be  a  powerful 
tool  that  greatly  enhances  the  usefulness  and  value  of  the  data. 

3.  More  specifically*  the  piezometer  data  base  package  Is  a  computerized 
system  that  provides  for  the  orderly  storage*  retrieval*  and  analysis  of 
piezometric  data  resulting  from  construction  or  routine  monitoring  of  these 
Instruments.  These  data  are  used  to  determine  the  Inferred  performance  of  the 
structures.  The  data  base  provides  the  flexibility  to  look  at  the  data  In 
various  forms  so  that  an  adequate  performance  evaluation  can  be  made.  As  most 
piezometer  data  are  evaluated  In  a  graphical  fotmat*  proper  use  of  the  data 
base  package  described  herein  can  reduce  the  tedious  task  of  graphical  prepa¬ 
ration  and  can  provide  a  more  effective  and  timely  evaluation  procedure. 
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Also,  the  use  of  this  type  of  data  base  package  can  be  very  helpful  In  satis¬ 
fying  reporting  requirements,  assuring  project  integrity,  and  providing  a 
tool  for  management  of  piezometer  reading  personnel. 


Background 

4.  The  need  for  the  use  of  data  base  management  systems  in  geotechnical 
engineering  was  identified  by  Hammer  and  Bennett  (1979).  In  particular,  the 
need  for  an  instrumentation  data  base  was  found  to  be  a  high  priority  item. 

The  criteria  for  this  package  were  developed  by  the  CAGE  instrimientation  task 
group  that  consisted  of  Division  and  District  personnel.  The  criteria  report 
describes  the  general  requirements  in  terms  of  the  user's  need  for  an  instru¬ 
mentation  data  base  management  system.  Those  requirements  for  the  package 
design  are  as  follows: 

The  package  must  be  suitable  for  general  use  throughout  the 
Corps. 

Data  entry  should  be  user  friendly  so  that  data  can  be  entered  by 
~  nonprogrammer  or  subprofessional  level  employees. 

_c.  Anomalous  data  should  be  flagged  for  further  Investigation  or 
“  action  using  user-defined  threshold  or  range  of  minimum-maximuff 
values. 

The  design  should  allow  for  easy  access  to  determine  the  inferred 
performance  of  the  structures. 

Graphic  programs  should  be  Included  to  present  data  in  various 
“  forms. 

Drafting  preparation  time  for  both  evaluation  procedures  and 
“  reporting  requirements  should  be  minimized. 

Another  aspect  of  the  criteria  report  was  the  use  of  the  data  base  as  a  man¬ 
agement  tool.  The  requirements  for  this  need  are  as  follows: 

A  check  should  be  made  to  determine  whether  readings  are  being 
taken  as  scheduled. 

]).  Inoperative  instruments  should  be  listed. 

J[,  Date  of  last  readings  for  all  Instruments  should  be  recorded. 
Remarks  to  clarify  questionable  readings  should  be  listed. 

5.  The  envisioned  instrumentation  data  base  package  will  be  usable  with 
six  basic  types  of  instruments.  Instead  of  developing  one  large  data  base, 
CAGE  decided  to  develop  a  series  of  smaller  data  bases  for  each  of  the  various 
instruments.  This  procedure  is  more  economical  for  the  user  who  is  dealing 


with  only  one  or  a  few  types  of  instruments.  This  report  will  deal  with 
piezometer  data,  a  high  priority  among  the  instrumentation  series.  The  rest 
of  the  series  consists  of  the  following  systems: 

a, .  Carlson  pressure  meters. 

b.  Strain  gages. 

£.  Settlement  points. 

Surface  movements. 

£.  Inclinometers. 

6.  The  criteria  report  was  completed  in  July  1981,  with  work  on  the 
package  beginning  at  that  time.  The  piezometer  data  base  was  put  in  use  at 
the  Pittsburgh  District  as  a  pilot  project  in  May  1982.  There  the  system  was 
refined  and  made  more  user  oriented. 


Applications 

7.  The  package  will  accomplish  the  following: 

£.  Use  a  simple  auestion-answer  type  data  entry,  usable  by  personnel 
with  very  little  training  required. 

b.  Provide  data  reduction  based  on  type  of  piezometer  and  user 
specification  of  appropriate  calibration  values. 

c.  Provide  for  recording  reservoir/ pool  levels. 

Compare  data  with  preset  values  or  ranges  and  issue  appropriate 
warnings  or  alerts. 

£.  Convert  90-deg  V-notch  weir  readings  from  cubic  feet*  per  second 
to  gallons  per  minute. 

£.  Recall,  display,  and  analyze  data  as  soon  as  loaded  to  data  base. 

£.  Provide  graphic  plots  for  reading  versus  time  curves,  cross 
section  plots,  plan  maos  of  location,  and  contours  of  water 
1 evel s . 

Ji.  Evaluate  and  compare  past  and  present  performance  data. 

j_.  Meet  requirements  for  management  tools  as  listed  in  paragraph  4. 

System  Requirement 

8.  In  order  to  use  this  data  base  package,  the  District/project  must 
have  a  means  of  accessing  the  programs  which  presently  reside  on  a  Control 


Data  Corporation  (CDC)  mainframe  computer.  All  Corps  of  Engineer  Districts 
have  access  to  this  computer  system  through  Corps-wide  Teleprocessor  Services 
Program  (TSP)  contract.  To  access  the  computer  to  enter  data,  the  project 
office  needs  to  have  use  of  a  time-sharing  terminal  with  the  necessary  equip¬ 
ment  to  transmit  data  over  telephone  lines.  The  type  of  terminal  the  District 
or  project  has  determines  the  quality  of  the  graphic  displays.  Any  type  of 
terminal  can  be  used  for  data  entry  and  retrieval  or  report  summaries. 

9.  The  number  of  people  who  should  be  trained  to  use  this  data  base 
package  Is  determined  by  the  number  of  piezometers  and  needs  In  the  District. 

If  data  entry  Is  centralized,  one  or  two  District  personnel  are  needed  to 
enter  and  retrieve  data.  Ideally,  data  would  be  entered  at  the  project  office 
and  loaded  to  the  data  base  at  the  District  office.  Retrieval  of  data  can  be 
accomplished  at  the  project  or  District  office.  It  is  desirable  that  several 
engineering  personnel  be  familiar  with  the  package.  The  data  collection 
program  was  designed  so  that  personnel  not  familiar  with  computers  can  Input 
data.  Retrieving  data  and  preparing  plots  require  some  knowledge  of  the 
storage  system  command  language.  Training  District/project  personnel  to  use 
the  data  base  system,  usually  a  three-day  process,  is  accomplished  by  CAGE 
project  personnel  who  will  visit  the  District/  project  site. 

10.  To  Implement  the  piezometer  data  base,  the  Dl strict/project  person¬ 
nel  need  to  contact  the  CAGE  project  personnel  at  WES.  A  meeting  will  be 
arranged  to  discuss  details  of  the  package  and  how  It  relates  to  the  user's 
needs.  The  CAGE  personnel  will  set  up  the  data  base  in  the  user's  CDC  account, 
transfer  other  associated  programs  presented  in  this  report,  along  with  train¬ 
ing  personnel  in  the  use  of  the  package, 

11.  The  project  cost  to  use  the  data  base  system  will  depend  upon  how 

much  data  are  entered  and  how  the  District  uses  the  system  for  data  retrieval. 

The  costs  for  various  examples  in  Parts  III  and  IV  are  shown  to  provide  an 

indication  of  the  total  operating  costs. 

Report  Organization 

12.  The  remainder  of  this  report  Is  broken  Into  three  parts.  Part  II 
describes  the  data  base  structure  and  lists  the  various  data  elements. 

Part  III  explains  the  various  procedures  to  enter  data  to  the  systefn. 


8 


PART  II;  DATA  STORAGE  SCHEME 


Data  Base  Structure 


13.  The  piezometer  data  base  uses  System  2000  (trademark  of  Intel  Systems 
Corporation)  as  the  data  base  management  system  (DBMS)  and  storage  software. 
This  system  Is  available  to  all  CE  Districts  on  the  CDC  mainframe  computer. 
System  2000  (S2K)  Is  a  hierarchical  or  tree-tyoe  DBMS  where  data  are  grouped 
Into  functional  units  at  each  level,  and  each  level  has  a  direct  relationship 
to  the  data  appearing  above  and  below  that  level.  A  schematic  of  the  data 
base  structure  Is  shown  In  Figure  1. 

14.  The  data  base  structure  Is  set  up  to  resemble  the  field  situation 
where  there  are  a  number  of  piezometers  for  every  project  with  multiple  read¬ 
ings  for  each  piezometer.  At  the  top  of  the  data  structure  (level  CCI  In 
Figure  1)  Is  the  project  Information.  This  level  contains  the  data  describing 
the  project(s)  such  as  location,  type  of  structure,  maximum  and  minimum  pool 
elevation,  tall  water  elevation,  and  Important  construction  dates.  Below  that 
level  (C4B  In  Figure  1)  Is  the  piezometer  infonnatlon  level  which  consists  of 
the  number  or  name  of  the  olezometers,  the  location,  top  of  riser  elevation, 
threshold  values,  and  other  specific  Information  about  the  piezometer.  Any  of 
this  Information  may  be  Irrelevant  to  the  user  and  Ignored.  However,  the 
threshold  values  are  more  than  just  stored  data  values;  they  can  be  used  for  a 
quick  data  check  and  for  Issuing  appropriate  warnings.  If  the  readings  exceed 
the  established  threshold  values,  the  warning  message  would  be  as  follows: 

1st  threshold  -  "Check  the  reading" 

2nd  threshold  -  "Reread  the  piezometer" 

3rd  threshold  -  "Check  the  piezometer" 

4th  threshold  -  "Notify  01  strict/project  engineer" 

The  threshold  messages  can  be  modified  to  meet  user  needs  by  changing  the 
wording  of  the  warning  message  (e.g.,  1st  threshold  -  "Check  reading  and  call 
District  If  correct").  The  last  level  (C9jJ  In  Figure  1)  Is  the  reading  level 
which  consists  of  readings,  dates,  method  used  to  obtain  reading,  and  any 
comment  or  remarks  about  the  reading.  The  project  data  are  entered  once  for 
each  project  while  the  piezometer  data  are  entered  for  each  instrument.  There 
will  be  many  piezometers  associated  with  one  project  and  many  readings  associ¬ 
ated  with  one  piezometer. 


Definition  of  l^ta  Elements 


15.  Within  each  repeating  group  or  level  of  the  data  base,  there  are 
individual  data  elements  which  have  names,  abbreviations,  component  numbers, 
and  other  attributes  identifying  the  type  of  data  that  will  be  retained. 

These  other  attributes  of  the  data  elements  are  an  indication  of  how  the  data 
element  is  stored  and  used  within  the  system,  the  data  type,  and  the  field 
size.  Each  data  element  is  stored  within  the  data  base  as  either  KEY  or 
NON-KEY,  depending  on  how  the  element  will  be  used.  If  the  data  element  is 
not  to  be  used  to  define  data  groups,  the  element  is  designated  as  a  NON-KEY 
element.  However,  if  the  element  will  be  used  to  define  specific  groups  of 
data  for  analysis,  the  element  is  designated  as  a  KEY  element.  Examples  will 
be  shown  in  Part  IV.  All  the  data  elements  within  the  system  fall  within  one 
of  the  following  four  types:  NAME  consists  of  any  combination  of  letters  or 
numbers  and  will  be  treated  as  text  material;  DATE  consists  of  a  fixed  format 
for  month,  day,  and  year;  and  two  types  of  numeric  data,  DECIMAL  (allows  a 
decimal  point)  and  INTEGER  (does  not  allow  a  decimal  point).  The  field  size 
is  the  maximum  number  of  characters  that  can  be  stored  for  a  particular 
element.  The  data  elements  and  their  attributes  are  listed  in  Table  1.  The 
component  numbers  from  Table  1  are  shown  on  the  schanatic  of  the  data  base 
structure  in  Figure  1. 

16.  Examples  for  selected  data  elements  are  shown  in  Table  2.  Units 
such  as  mean  sea  level  (msl),  feet,  or  pounds  per  square  inch  (psi)  are  not 
entered  or  stored.  Thus,  units  for  numerical  values  need  to  be  Known  and 
should  be  listed  with  the  data  elements  on  a  readily  available  reference 
sheet.  Another  important  item  is  the  need  for  unique  piezometer  names  for 
each  project.  The  same  instrument  name  can  be  used  for  different  projects  but 
not  within  the  same  project. 


Uses  of  Stored  Data 

17.  The  main  advantage  of  the  piezometer  data  base  package  is  the  rapid 

retrieval  and  graphical  display  of  specific  information  or  readings.  The 

package  provides  the  following  additional  advantages: 

i.  Provides  an  efficient  organized  system  for  monitoring  piezome- 
“  ters  required  for  dam  safety  evaluations. 
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C90  PRB)  Repeating  Group  for  Plee  Readings 

d4l  PDTRD  Date  Reading  Key  DATE  10  characters 

C93  PREAD  Reading  (elevation)  Key  DECIMAL  5  digits 

C95  PMDRD  Method  of  Obtaining  Reading  Key  HAME  15  characters 

C97  PRM  Remarks  Key  NAME  20  characters 
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b.  Eliminates  tbne-consum1n(i  suimnarlzatlons  of  data  for  periodic 
Inspections. 

c.  Provides  an  organized  system  for  management  of  reading  schedules 
and  piezometer  status. 

d.  Allows  rapid  data  reduction  and  flags  readings  outside  user 
specified  limits. 

e.  Provides  time-history  plots  and  cross-section  plots  with  piezom¬ 
eter  readings  for  geologic  and  soils  studies. 


PART  III:  DATA  INPUT 


General 


18.  There  are  two  procedures  available  to  the  user  for  entering  data  to 
the  data  base.  The  procedure  which  will  be  described  In  this  section  entails 
using  a  data  entry  program  that  generates  a  data  file  which  Is  loaded  to  the 
data  base  at  the  user's  convenience.  This  program  uses  a  question-answer  type 
format  to  collect  the  data.  To  allow  any  data  currently  digitized  on  a  com¬ 
puter  file  to  be  loaded  to  this  data  base  system,  a  card  format  type  of  data 
file  was  developed.  Thus,  by  reformatting  the  data  Into  the  format  shown  In 
Table  3,  the  load  procedure  described  later  In  this  section  can  be  utilized. 
The  second  procedure  Is  to  update  or  modify  the  data  by  direct  access  to  the 
data  base  files  while  the  user  Is  working  on  line  with  the  data  base.  This 
procedure  will  be  described  In  a  section  of  Part  IV,  "Interactive  Data  Modifi¬ 
cation."  This  method  Is  more  costly  when  compared  to  the  first  procedure 
which  only  accesses  the  data  base  when  the  data  Is  being  loaded. 

Data  Entry  Program  -  Using  a  Data  File 


Description 

19.  This  data  entry  procedure  consists  of  two  programs.  The  first 
program  is  designed  to  collect  raw  data  and  build  a  data  file  that  will  be 
properly  loaded  into  the  data  base  when  the  second  program  is  executed.  The 
data  entry  or  first  program  operates  on  a  time-sharing  basis  in  a  conversa¬ 
tional  mode.  A  version  of  the  data  entry  program  is  available  on  the  Harris 
computer.  The  data  file  generated  must  be  transferred  to  the  CDC  computer 
because  the  data  base  must  reside  on  this  mainframe.  The  data  entry  program 
prompts  the  user  for  the  data  on  an  item  by  Item  basis,  starting  at  the  proj¬ 
ect  Infonnatlon  level  and  proceeding  to  all  lower  levels.  After  each  prompt, 
the  computer  waits  for  a  carriage  return  before  proceeding.  Once  the  user 
becomes  familiar  with  the  entry  questions,  a  short  prompt  (up  to  six  charac¬ 
ters  each)  option  is  available  to  save  the  time  required  to  print  the  long 
prompts.  The  prompts  used  to  request  each  Itan  are  contained  In  a  separate 
driver  file  (ORVPIZ)  that  the  entry  program  accesses  (shown  In  Table  4).  By 
having  this  separate  file,  users  can  modify  the  prompts  for  their  particular 
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Table  U 


Prcmpts  for  Requested  Information  in  Data  Entry  Program 


Project 

Information 


PROJECT  NAME< INPUT  END  TO  QUIT)? 

PRNAME 

PROJECT  RIUER?  £ong  jMompt 

PRIVER 

PROJECT  STATE'S* 

PSTATE  hkofit  p^mpt 

PROJECT  TOWN? 

TOWN 

DISTRICT? 

DIST 

TYPE  OF  STRUCTURE? 

TYPEST 

CREST  ELEVATION? 

CRELEV 

SPILLWAY  ELEVATION? 

SPELEV 

MAXIMUM  POOL  ELEVATION? 

MXELEV 

MINIMUM  POOL  ELEVATION'S* 

MNELEV 

NORMAL  POOL  ELEVATION? 

NORMEL 

MAXIMUM  TAILWATER  ELEVATION? 

MXTWEL 

MINIMUM  TAILWATER  ELEVATION? 

MNTWEL 

NORMAL  TAILWATER  ELEVATION? 

NOTWEL 

POOL  OF  RECORD? 

POOL 

DATE  OF  POOL  RECORD? ( MM/DD/YY ) 

POOLDT 
ALERT  POOL? 

ALERTP 

DATE  CONSTRUCTION  BEGAN'?  ( MM/DD/YY  > 
CONSTRT 

DATE  CONSTRUCTION  COMPI  ETED*!*  (  MM/DD/YY  ) 
CONFIN 

(Continued) 
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Piezometer 

Information 


"able  U  (Continued) 


PIEZOMETER  OR  GAUGE  NUMBER? 

PIZNM 

FEATURE  DESCRIPTION'!‘(  10  CHAR.  MAX) 

FEATRE 

STATI0N?(8  CHAR.  MAX) 

STAT 

OFFSET  OR  STATI0N?<8  CHAR.  MAX) 

OFFSET 

PIEZOMETER  TIP  ELEVATION? 

TIPEL 

TOP  OF  RISER  OR  GAUGE  ELEVATION? 

TOR 

GROUND  SURFACE  ELEVATION? 

6SE 

RISER  PIPE  DIAMETER? 

RPD 

SOIL  TYPE  AT  TIP?(7  CHAR,  MAX) 

SOILTY 

TYPE  OF  PIEZ0METER?(20  CHAR.  MAX) 

PIZTYP 

STATUS  OF  PIEZOMETER?( 10  CHAR.  MAX) 

PZSTAT 

DATE  OF  INSTALLATION?(MM/DD/YY)  • 

DOINS 

LOCATION  OF  INSTALLATION  REP0RT?(10  CHAR.  MA: 
REPLOC 

METHOD  OF  INSTALLATION? < 25  CHAR.  MAX) 

METHOD 

INSTALLED  BY?<15  CHAR.  MAX) 

BY 

METHOD  OF  TESTING?<15  CHAR.  MAX) 

METHOD 

REFERENCE  DRAWING?  (20  CHAR,  MAX.) 

REFDRW 

CALIBRATION  COivSTANTT 
CALCON 

FILTER  MATERIAL?-:  15  CHAR,  MAX) 

FILMAT 

TOP  ELEVATION  OF  FILTER? 

TOPEL 

BOTTOM  ELEVATION  OF  FILTER? 

BOTEL 

SEAL  MATERIAL?! 15  CHAR.  MAX) 

SEAL 

TOP  ELEVATION  OF  SEAL? 

TOPELS 

BOTTOM  ELEVATION  OF  SEAL? 

BOTELS 

DATE  OF  LAST  READING? ( MM/DD/YY ) 

READDT 

(Continued) 
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Table  h  ( Concluded ) 


Reading 

Group 


DATE  OF  NEXT  READ ING? ( MM/DD/YY ) 

NXTRDG 

INTERVAL  BETWEEN  READING?(10  CHAR.  MAX) 

NTRVL 

1ST  THRESHOLD  VALUE? 

THRSHl 

2ND  THRESHOLD  VALUE? 

THRSH2 

3RD  THRESHOLD  VALUE"? 

THRSH3 

4TH  THRESHOLD  VALUE'’ 

THRSH4 

DATE  OF  READING ( INPUT  11/11/99  TO  OUIT  )( MM/DD/YY) 
RDGDAT 

READING  VALUE'I’ 

RDGVAL. 

METHOD  OF  READIN6?(15  CHAR.  MAX ) 

RDGMET 

REMARKS?(20  CHAR.  MAX) 

REMARK 


f 
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District  without  affecting  the  data  entry  program.  After  a  series  of  ten 
Items  have  been  entered,  the  data  will  be  automatically  listed  for  the  user  to 
check.  Any  changes  can  be  made  at  this  time  by  following  Instructions  that 
are  printed  with  the  listed  data.  Once  the  user  agrees  that  all  the  Items  are 
correct,  more  data  can  be  entered.  If  a  mistake  Is  found  at  some  later  time, 
the  user  will  not  be  able  to  go  back  and  make  the  correction  while  using  the 
data  entry  program.  The  user  will  have  to  change  the  value  using  the  modify 
procedure  during  another  data  entry  session,  change  the  formatted  data  file 
(not  recommended),  or  follow  the  CHANGE  procedure  described  In  the  next 
section. 

20.  The  data  entry  program  contains  some  editing  capabilities  In  addi¬ 
tion  to  allowing  the  user  to  change  the  Input  values.  Besides  the  prompts, 
the  information  in  Table  5  Is  contained  In  the  driver  file  that  the  data  entry 
program  accesses.  The  first  column  Indicates  the  type  of  data  Item.  The 
following  chart  shows  the  numeric  definition  of  the  different  data  types: 

Type  1  —  Integer  number 
Type  2  Decimal  number 

Type  3  —  Character  name 
Type  4  Date 

The  second  column  Indicates  the  length  of  the  variable.  The  number  of  10- 
letter  computer  words  Is  shown  for  character  and  date  Items,  v4i11e  the  number 
of  digits  is  shown  for  numeric  Itens.  The  next  two  columns  contain  the  mini¬ 
mum  and  maximum  values  of  numeric  data  Items.  If  both  values  are  zero,  the 
item  will  not  be  checked;  however,  if  one  value  Is  nonzero,  the  data  are 
checked  to  ensure  that  the  input  value  Is  within  the  minimum-maximum  range. 

If  the  entered  value  is  outside  the  range,  the  program  will  print  the  follow¬ 
ing  message  and  will  prompt  the  user  for  the  same  data  Item  again: 

(entered  value)  IS  NOT  WITHIN  THE  LIMITS:  r(iTiin1mum,  maximum)!. 

The  ranges  should  be  set  up  when  the  system  Is  Initiated;  however,  the  values 
can  be  changed  when  needed.  The  next  columns  In  the  file  contain  the  data 
base  name  of  the  Item.  The  last  column  Is  the  maximum  number  of  characters 
for  each  character  and  date  element.  Using  this  Information,  the  program 
knows  the  type  of  data,  the  size,  and  a  range  for  numeric  values;  thus,  any 
large  errors  (wrong  data  type  or  shifts  In  the  decimal  point)  are  caught  and 
the  user  Is  required  to  enter  corrected  values  before  the  program  continues. 


Table  5 

Data  Element  Specifications 


Type  Length 


Limits 


(Continued) 


Number  of 
Characters 


3 

0. 

0. 

PROJ-NAHE 

30 

3 

0. 

0. 

PROJ-RIVER 

30 

1 

0. 

0. 

PROJ-STATE 

5 

2 

0, 

0. 

PROJ-TOWN 

20 

1 

0. 

0. 

DIST 

5 

n 

0. 

0. 

TYP-STRT 

20 

6 

990. 

1210. 

CRT 

6 

0. 

0. 

SPY 

6 

980. 

1020. 

HXPL 

6 

930. 

960. 

MNPL 

6 

940. 

990. 

NRPL 

6 

900. 

955. 

MXTW 

6 

880. 

940. 

MNTW 

6 

0. 

0. 

NRTW 

6 

980. 

1100. 

RECPL 

1 

0. 

0. 

DRPL 

6 

0. 

0, 

ALTPL 

1 

0. 

0. 

CONT-BEG 

1 

0. 

0. 

CONT-COM 

1 

0. 

0. 

PNO 

7 

1 

0. 

0. 

PFD 

10 

1 

0. 

0. 

PSTA 

8 

1 

0. 

0. 

POFF 

8 

6 

800. 

1000. 

TIPEL 

6 

900, 

1030. 

TREL 

6 

900. 

1100. 

PGS 

5 

0. 

RPD 

1 

0. 

0. 

TPSL 

7 

2 

0. 

0. 

TYPIEZ 

20 

1 

0,. 

0. 

PSAT 

10 

1 

0, 

0. 

PDI 

1 

0. 

0. 

LOCINT 

10 

3 

0. 

0. 

PMIT 

25 

0. 

0. 

PIB 

15 

2 

0. 

0. 

PTEST 

15 

2 

0, 

0. 

REFD 

20 

5 

0. 

100. 

CALB 

2 

0. 

0. 

FLTMAT 

15 

6 

0, 

0. 

TPFLT 

V  f  ■■ 


Table  5  (Concluded) 


Type 

Length 

Linlts 

Name 

Min. 

Max. 

2 

6 

0. 

0. 

BTFLT 

3 

2 

0. 

0. 

SALHAT 

2 

6 

0. 

0. 

TPSEAL 

■7 

6 

0. 

0. 

BTSEAL 

4 

1 

0. 

0. 

PDTLR 

4 

1 

0. 

0. 

PDTNR 

3 

1 

0. 

0. 

PINT 

<7 

6 

850. 

1100. 

PTHl 

2 

6 

850. 

1100. 

PTH2 

*7 

6 

850. 

1100. 

PTH3 

2 

6 

850. 

1100. 

PTH4 

4 

1 

0. 

0. 

PDTRD 

2 

6 

0. 

0. 

PREAD 

3 

9 

0. 

0. 

PHDRD 

3 

2 

0. 

0. 

REMARKS 

Key  ^OA.  Type  Codei 

1-Inte^eA 

l-VecAJnxt 

i-ChanjoeXzK 

4-V<vte 


The  user  can  modify  the  prompts,  the  range  values,  or  the  order  of  the  prompts 
by  using  an  editor.  The  data  element  names  must  not  be  changed,  since  they 
are  used  In  loading  data  to  the  data  base. 

21.  The  user  should  be  avere  of  the  following  cautions  for  use  of  this 
procedure: 

Data  should  always  be  entered  with  no  leading  blanks.  Do  not 
use  a  colon  In  any  Input  because  the  characters  following 
the  colon  w111  not  be  stored  by  System  2000. 

j>.  The  collection  program  checks  project  names  and  piezometer 
numbers  that  were  previously  entered.  However,  If  a  new  value 
Is  entered  Incorrectly,  the  Incorrect  number  will  be  stored  In 
the  data  base  unless  It  Is  corrected  before  loading  to  the  data 
base. 

£.  The  following  error  messages  are  generated  by  the  data  collec¬ 
tion  program  as  a  result  of  Its  Internal  editing: 

OOPS!  NOT  A  VALID  INTEGER,  TRY  AGAIN 
OOPS!  NOT  A  VALID  REAL.  TRY  AGAIN 
OOPS!  NOT  A  VALID  DATE.  TRY  AGAIN 

The  collection  program  also  checks  the  Input  format  for  dates 
and  that  values  for  days  do  not  exceed  31  and  for  month,  does 
not  exceed  12. 

In  the  collection  program,  all  data  entered  Is  printed  back  to 
the  user  for  editing  except  for  the  piezometer  number.  If  this 
number  Is  entered  Incorrectly,  the  best  way  to  change  the  number 
is  to  edit  the  data  file  before  loading  the  data  to  the  data 
base. 

Accessing  and  operation  of  the  collection  program 

22.  To  access  the  data  entry  program  the  following  commands  are  used: 
GET,  INPPIZ  (for  INPUT  piezometer) 

CALL,  INPPIZ 

or  simply 

-INPPIZ 

The  collect  program  creates  a  data  file  called  DATPIZ,  On  the  Harris  com¬ 
puter,  the  same  command  without  the  Is  used. 

23.  The  schematic  of  the  collection  program  (Figure  2)  Illustrates  how 
the  system  works.  The  first  question  the  system  asks  the  user  Is  "Do  you  want 
shortened  prompts?"  The  answer  to  this  question  will  determine  which  prompts, 
the  full  length  or  the  short  ones  with  a  maximum  six  characters,  are  used  for 
the  current  session  of  the  collection  program.  The  user  should  be  well  ac¬ 
quainted  with  the  program  before  using  the  shortened  prompts  option.  The  next 


PROJECT  NAME 


NEW  ' 

PROJECT 

>MOOIF^ 

yes/  project 

r^^INFORMATIOI 


LD  PROJECT 


PROJECT 

INFORMATION 


PIEZOMETER  OPTIONS 

1.  ENTER  NEW  PIEZOtyCTER 

2.  MODIFY  PIEZOMETER  DATA 

3.  ENTER  READING  FOR  EXISTING 
PIEZOMETER 

4.  ENTER  READINGS  FOR  ALL 
EXISTING  PIEZ.  FOR  A  PROJECT, 
PROMPTED  WITH  PIEZ.  NAME 

5.  NO  MORE  DATA 


OPTION  S 


OPTIONS 
I  AND  2  1 


joPTION  3 
IPIEZOMETERI 


OPTION  4 


/lORE^ 
READINGS 
FOR  THIS 
SwPIEZ.  ^ 


reading 
PROMPTED  BY 
PIEZOMETER 
NUMBER  I 


r  MORE  ypg 
J«EADING»i^ 


question  Is  the  prompt  for  project  name.  After  a  carriage  return.  It  will  ask 
If  this  Is  a  new  or  old  project.  At  this  point  a  file  PZPRFL  (PIEZOMETER 
PROJECT  FILE)  Is  accessed.  This  file  contains  a  listing  of  all  the  current 
project  names.  It  does  an  Inventory  of  the  project  name  to  confirm  that  the 
entered  name  Is  either  a  new  or  an  old  project.  If  It  disagrees  with  the 
user's  answer.  It  will  respond  with  either  “PROJECT  X  ALREADY  EXISTS.  TRY 
AGAIN"  or  “PROJEa  X  DOES  NOT  EXIST,  TRY  AGAIN”  and  prompts  the  user  for  the 
project  name  again.  This  checking  Is  done  to  avoid  problems  such  as  duplica¬ 
tion  of  names  or  misspelled  name.  Duplication  of  project  names  can  cause 
problems  with  the  attachment  of  wrong  piezometers  to  a  project.  The  System 
2000  command  language  checks  the  entire  name  against  the  stored  names,  thus 
requiring  precise  spelling.  For  a  new  project,  the  user  will  have  the  follow¬ 
ing  options: 

1 .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2.  CREATE  MY  PROMPT  SEQUENCE 

3.  USE  THE  TAILORED  PROMPT  SEQUENCE 

4.  KEEP  THE  CURRENT  PROMPT  SEQUENCE 

Option  1  will  prompt  the  user  for  all  components  1  through  24. 

Potion  2  will  let  the  user  generate  a  specific  prompt  sequence.  This 
ootlon  will  allow  the  user  to  be  prompted  In  whatever  order  the  data  appears 
on  the  data  forms.  If  this  sequence  Is  saved.  It  will  replace  the  previous 
tailored  prompts  sequence  In  option  3.  If  more  than  one  project  Is  being 
entered  during  the  same  session,  the  prompt  sequence  will  be  the  current 
prompt  sequence  (option  4)  for  the  next  project.  The  complete  listing  of  the 
prompts  Is  available  If  required. 

Option  3  Is  the  tailored  sequence  saved  In  option  2. 

Option  4  Is  the  tailored  sequence  created  In  option  2. 

Different  options  will  be  used  throughout  the  examples  shown  later  In  this 
section.  For  an  old  project,  the  program  will  allow  the  user  to  edit  or 
modify  the  project  data  that  already  exist  in  the  data  base  by  reentering  the 
values  to  be  changed.  The  options  listed  above  are  available  for  modifying 
data. 

24,  The  next  series  of  prompts  are  for  piezometer  Infonnatlon.  The 
options  for  this  level  are  as  follows: 

1.  INPUT  NEW  INSTRUMENT 

2.  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 


3.  IHPUT  READINS  VALUES 

4.  BE  PRONPTED  FOR  SETS  OF  RB/OINGS 

5.  NO  MORE  INSTRUMENTS  TO  ENTER 

Options  1,  2,  3,  and  4  access  the  file  PZFL  (PIEZOMETER  FILE)  which  contains  a 
listing  of  a11  the  piezometer  names  and  types.  A  list  of  the  various  piezom¬ 
eter  types  Is  shown  In  paragraph  26.  PZFL  Is  the  check  list  for  piezometer 
names  like  the  project  check  list,  PZPRFL.  These  files  are  automatically 
updated  when  a  new  project  or  piezometer  Is  entered.  Option  1  checks  file 
PZFL  to  ensure  that  duplicate  piezometer  names  are  not  entered  for  the  same 
project,  and  options  2  and  3  check  PZFL  to  ensure  that  the  piezometer  name 
exists.  Options  1  and  2  provide  for  the  entering  or  modifying  of  piezometer 
Instrument  data  (components  41  through  88).  For  these  two  options,  the  user 
will  be  presented  with  the  four  prompt  choices  described  In  paragraph  23. 

After  piezometer  Information  Is  entered,  the  program  will  prompt  for  reading 
values  as  done  In  option  3  which  will  prompt  the  user  for  the  reading  Informa¬ 
tion  (components  91  through  97).  With  option  3,  several  readings  can  be 
entered  for  one  piezometer.  Option  4  provides  for  the  entry  on  one  reading 
for  all  piezometers  associated  with  a  project.  Option  4  accesses  the  file 
PZFL  for  the  appropriate  piezometer  numbers.  This  option  Is  very  convenient 
If  the  user  needs  to  update  all  the  piezometers  for  one  reading  date.  Option  5 
should  be  selected  when  a  user  has  finished  Inputting  data  for  that  project. 

The  user  can  then  either  continue  on  to  another  project  and  repeat  the  process 
or  terminate  the  data  entry  program. 

25.  The  procedure  used  to  reduce  the  raw  piezometer  data  Is  based  on  the 
type  of  piezometer.  If  the  type  of  piezometer  Is  not  present  In  the  PZFL 
file,  or  Is  not  one  of  the  values  shown  In  paragraph  26,  the  following  options 
will  be  presented  for  data  reduction: 

FOR  THESE  PIEZOMETER  READINGS  ARE  YOU  ENTERING 

1.  ELEVATION  VALUES 

2.  DEPTH  VALUES  FROM  TOP  OF  RISER  IN  FT 

3.  PIEZ.  TIP  GAUGE  PRESSURE  PSI  VALUES 

4.  U.  P.  GAUGE  PRES9JRE  PSI  VALUES 

5.  OTHER  TYPE  GAUGE  PRESSURE  PSI  VALUES 

6.  WATER  LEVEL  GAUGE  READING  IN  FEET 

7.  PNEUMATIC  READINGS  IN  PSI 


Option  1  Is  used  Mhen: 

The  user  Is  entering  the  reading  as  an  elevation,  and  no  calcula¬ 
tion  Is  required. 

b.  The  weir  Is  entered  for  the  piezometer  number,  and  the  reading 
~  value  Is  In  cubic  feet  per  second.  For  this  case,  the  following 

equation  Is  used  by  the  program  to  convert  weir  readings  entered 
In  cubic  feet  per  second  to  gallons  per  minute: 

C93  *  READING  IN  GPM  «  448.3  x  [  2.5  x  (readlng-CTl)^*®  ] 

If  there  Is  not  a  zero  weir  value  In  component  71,  then  the 
equation  Is: 

C93  -  448.3  X  [  2.5  X  (readlng)^*^  ] 

The  constants  are  based  on  unit  conversions  and  9n-deg  V-notch 
weir  equations  from  Streeter  and  Wylie  (1975). 

£.  When  a  piezometer  Is  dry,  frozen,  or  reading  9  psi,  the  user 

should  enter  DRY  PIZ,  FROZEN,  or  9  PSI.  The  program  will  convert 
the  character  data  to  a  numeric  value  which  Is  used  for  Indicat¬ 
ing  these  special  cases  on  data  plot.  The  numeric  values  corre¬ 
sponding  to  the  various  cases  are: 

DRY  PIZ  9999.9 

9  PSI  8888.8 

FROZEN  7777.7 

Option  2  Is  used  when  the  user  Is  entering  the  reading  as  a  depth.  This 
option  will  convert  depth  readings  to  elevation  readings  using  the  top  of 
riser  elevation  stored  In  C51  from  the  piezometer  information  level.  Thus, 
READING  IN  ELEVATION  =  TOP  OF  RISER  ELEVATION  -  DEPTH 
C93  »  C51  -  (reading) 

Option  3  is  used  when  the  user  Is  entering  the  readings  for  an  air-actuated 
piezometer.  For  this  reduction  procedure,  the  tip  elevation  must  be  stored  In 
conponent  41.  The  calculation  Is  done  by: 

ELEVATION  -  PRESSURE  AT  PIEZ01CTER  TIP  x  2.31  +  TIP  ELEVATION 
C93  =  (reading)  x  2.31  +  C49 

Option  4  Is  used  when  the  user  Is  entering  readings  for  uplift  cell  gauges  In 
units  of  psi.  The  gauge  elevation  Is  stored  In  component  51  (top  of  riser 
elevation)  for  this  procedure.  For  this  option  the  reduction  equation  Is: 


ELEVATION  *  UPLIFT  PRESSURE  x  2.31  +  TOP  OF  RISER  ELEVATION 

(gauge  elevation) 

C93  *  (reading)  x  2.31  +  C51 

Option  5  is  similar  to  the  fourth  option  but  for  gauge  pressure  instruments 
where  the  readings  are  in  pounds  per  square  inch  (e.g.,  a  pressure  gauge  at 
the  top  of  riser  pipe). 

ELEVATION  =  GAUGE  PRESSURE  2.31  +  TOP  OF  RISER  ELEVATION 
C93  =  (input  value)  x  2.31  +  C51 

Option  6  is  used  when  the  user  is  entering  water  level  (staff)  gauge  readings 
in  feet.  The  elevation  for  the  zero  gauge  reading  must  be  stored  in  component 
51  (top  of  riser  elevation)  for  this  reduction  procedure.  The  output  will  be 
calculated  by: 

aEVATION  =  WATER  LEVEL  GAUGE  READING  +  TOP  OF  RISER  ELEVATION 

(zero  gauge  elevation) 

C93  *  (input  value)  +  C51 

Option  7  is  used  when  the  user  is  entering  pneumatic  readings  in  psi.  The 
Calibration  constant  is  stored  in  component  71  and  the  output  is  calculated  as 
follows: 

aEVATION  «  [(PNEUMATIC  READING  +  C«.B.  CONSTANT)  x  2.31]  + 

TIP  ELEVATION 

C93  =  [((READING)  +  C71)  x  2.31]  +  C49 

26.  The  files  PZPRFL  and  PZFL  are  accessed  and  modified  during  both 
data  entry  and  loading  procedures.  If  a  project  or  piezometer  name  is  new 
and  misspelled,  that  name  will  appear  in  either  PZPRFL  of  PZFL.  The  user 
will  need  to  recreate  these  files  by  using  the  following  command: 

-BLDPIZ  (for  build  piezometer  files) 

Table  6  shows  examples  of  the  PZPRFL  and  PZa  created  by  the  above  procedure. 
The  PZPRFL  includes  the  project  name,  the  number  of  the  first  project  piezome¬ 
ter,  and  the  number  of  instruments  associated  with  the  project.  The  PZa 
includes  the  piezometer  name  and  type.  The  piezometer  type  ahd  the  associated 
data  reduction  option  are  shown  below.  Several  abbreviations  are  used  to 
indicate  the  piezometer  type  of  those  instruments  which  are  not  piezometers. 
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Table  6 


Examples  of  PZPRFL  and  PZFL 


PZPRFL: 


Pro.ject  Names 


Position  of 
Piezometers 


MICHAEL  KIRWAN  i 

T I ONES T A  LAKE 


’'ZFL: 


Piezometer  Names  Types  of  Piezcaneters 


70-C-l 

OPEN  STANDPIPE 

70-C-2 

OPEN  STANDPIPE 

70-C-3 

OPEN  STANDPIPE 

70-C-4 

OPEN  STANDPIPE 

POOL 

POOL 

PRECIP. 

PRECIP. 

70-C-5 

OPEN  STANDPIPE 

70-C-6 

OPEN  STANDPIPE 

29-BC 

GAUGE  ON  STANDPIPE 

38-AC 

OPEN  STANDPIPE 

48-AWP 

GAUGE  ON  STANDPIPE 

50-AWP 

OPEN  STANDPIPE 

78-T-l 

OPEN  STANDPIPE 

78-T-2 

OPEN  STANDPIPE 

Total  Number 
Piezometers 


12 

o 


i. 


These  special  types  are  for  weather  (HEATH,),  air  tanperature  (A.T,),  precipi¬ 
tation  (PRECIP,),  upper  gauge  (U/fi),  lower  gauge  (L/G),  and  tallwater  (T.H,). 
The  spelling  of  piezometer  types  must  be  exact  for  the  program  to  retrieve  the 
correct  code. 


Readi ng/Number 


_ Piezometer  Type _  option/code 

POOL.  WEATH, .  SUMP.  A,T, .  1 

PRECIP,.  WEIR 

OPEN  STANDPIPE,  RELIEF  WELL  2 

STANDPIPE  BUBBLER  3 

U,P.  CELL  4 

GAUGE  ON  STANDPIPE  5 

U/G,  L/G,  T,W,  6 

PNEUMATIC  7 


If  the  piezometer  type  listed  In  component  59  and  PZFL  file  corresponds  to 
one  of  the  above  names,  the  user  will  not  have  to  choose  the  data  reduction 
option, 

27,  After  each  data  entry  session,  all  data  Is  appended  to  the  end  of  a 
data  file  called  DATPIZ,  It  Is  not  recommended  that  the  user  attempts  to  edit 
this  data  file  due  to  the  data  fonnatting  shown  In  Table  3  and  because  the 
data  file  will  not  be  loaded  correctly  If  data  fields  are  shifted. 

Accessing  and  operation  of  load  programs 

28.  At  the  user's  convenience  the  data  file  DATPIZ  may  be  loaded  to  the 
data  base  by  the  following  command: 

-UPDPIZ  (for  update  piezometer) 

This  loading  procedure  Is  done  Interactively;  therefore,  the  just-loaded  data 
are  available  Immediately  for  retrievals.  The  user  should  back  up  the  data 
base  after  each  Interactive  load  using  the  procedure  presented  In  Appendix  A, 
To  reduce  the  cost,  the  user  may  want  to  load  the  data  using  a  batch  method 
with  a  lower  job  priority.  To  use  this  procedure,  the  user  must  type: 


BEGIN,,  UPDPIZB  (for  update  piezometer  batch) 


The  terminal  response  Is  "submit  complete"  and  the  assigned  job  name.  The  job 
priority  number  may  be  assigned  by  the  user  on  the  JOB  card  in  the  UPDPIZB 
procedure  file.  The  process  time  is  also  dependent  on  the  number  of  higher 
priority  jrt)s  waiting  to  be  executed.  It  is  recommended  that  batch  loading  be 
done  overnight  so  that  the  data  base  Is  not  Inaccessible  to  the  user  during 
the  day,  or  the  load  procedure  Is  terminated  because  the  data  base  Is  in  use. 
The  load  process  requires  exclusive  use  of  the  data  base  and  will  automati¬ 
cally  back  up  the  data  base.  To  check  the  status  of  a  batch  job,  the  user 
must  type  In 

ENQUIRE,  JN  *  yyy  where  yyy  =  last  three  letters  of  the  computer 

assigned  batch  job  name 

29.  During  the  load  process  a  file  called  SUMFLE  (for  summary  file)  Is 
created.  This  Is  a  summary  listing  of  the  data  that  are  loaded  to  the  data 
base.  If  any  problems  within  the  load  program  develop  between  the  data  and 
data  base  during  the  load  process,  the  error  message  will  be  In  this  file.  It 
will  also  help  the  user  to  determine  what  kind  of  error  there  Is  and  where  the 
error  Is  located.  The  batch  loading  may  be  checked  In  the  same  way.  In 
addition  to  the  SUMFLE,  a  batch  job  also  generates  a  file  called  PI7.0AY,  which 
contains  all  steps  of  execution.  If  a  FORTRAN  execution  error  occurred  during 
loading  and  SUMFLE  was  not  updated,  the  PIZOAY  file  should  be  checked.  This 
file  will  contain  system  errors  that  may  have  damaged  the  data  base.  Table  7A 
shows  an  example  of  SUMFLE  (called  SUMPIZ  henceforth)  with  no  errors.  Table  7b 
illustrates  the  file  when  an  error  has  occurred  and  shows  how  to  correct  It. 
Table  8  is  an  example  of  PIZDAY,  If  the  following  error  message  Is  generated 
In  the  SUMPIZ  during  an  Interactive  loading  procedure,  the  user  needs  to 
contact  the  system  administrator  to  determine  where  the  error  Is: 

WRAPUP  CALLED  FROM: 

SUBROUTINE  "ROUTINE  NAME" 

AFTER  THE  DB  OPERATION  OF  "DATA  BASE  OPERATION" 

WITH  A  RETURN  CODE  OF  "RETURN  CODE" 

WITH  A  LEVEL  NUMBER  OF  "LEVEL  OF  DATA  BASE  WHERE  ERROR  OCCURRED" 


/QLI'rSUMPIZ 

/LI'S? 

PROJECT  MICHAEL  KIRWAN 


PIEZ 

70-C-  1 

INSERTED 

READING 

1982/09/23 

969.10 

READING 

1982/10/27 

970.10 

PIEZ 

29-BC 

INSERTED 

READING 

1982/09/23 

1070,90 

READING 

1982/10/27 

1070.90 

PIEZ 

PRECIP. 

INSERTED 

READING 

1982/09/23 

.  10 

PIEZ 

POOL 

INSERTED 

READING 

1982/09/23 

976,30 

PIEZ 

70-C-2 

INSERTED 

READING 

1982/09/23 

931.80 

/OLD? SUMP  I Z 
/LIST 

PROJECT  MICHAEL  KIRWAN 
READING  1983/05/25  44.60 

WRAPUP  CALLED  FROM? 

SUBROUTINE  IPIEZD 
AFTER  THE  DB  OPERATION  OF  INSERT 
WITH  A  RETURN  CODE  OF  10 
WITH  A  LEVEL  NUMBER  OF  1 


Table  8 

Error  Message  Files 


PIZDAY: 


16.36.05. JOB* CM200000»T2000fP8» 

16. 36. 05. ABF  •  INPUT  »  0 . 003KI0DB *  01 , 

16.36.05.USER»CER0W9»  »K0E< 

16,36.05.ABG  j  P6. 

16.36.06.CHARGE»CEROEGC»CEROW9. 

16.36.06.MAP»0FF. 

16.36.06.GET.SUMFLE. 

16.36.06.GET»S2KGET/UN=CECE2K. 

16.36.07.GET>TRANFL, 

16.36.07.GET»DATPIZ. 

16.36.07.6ET»SUMFLE, 

16.36.07.GET,PIZM0DU/UN=CER0W9. 

16.36.08.PIZM0DU< 

16.36.17. FTN  -  FATAL  ERROR  78 

16.36. 18.  EXIT. 


FORTRAN  ERROR: 


0  RECORD  AT  066251  PIEZ115T.M.  09/23/82Y29 . 9 

12345678901234567890 . ' . . . . 1234567890 

*  ERROR  DATA  INPUT  *  ILLEGAL  DATA  IN  FIELD  *'# 

ERROR  NUMBER  78  DETECTED  BY  INCOM=  AT  ADDRESS  000210 
CALLED  FROM  KRAKER=  AT  ADDRESS  000345 
CALLED  FROM  DECODE=  AT  ADDRESS  000041 
CALLED  FROM  IPIEZD  AT  LINE  38 

CALLED  FROM  HPIEZ  AT  LINE  156 

CALLED  FROM  HANRDS  AT  LINE  50 

CALLED  FROM  DOPIEZ  AT  LINE  18 

CALLED  FROM  MAIN  AT  LINE  103 

FTN  -  FATAL  ERROR  78 

FTN  -  FATAL  ERROR  78 


i 


A  transaction  file,  called  PZTRFL  (PIEZOMETER  TR/WSACTION  FILE)  Is  also  gener¬ 
ated  at  this  time.  This  file  contains  the  reduced  data,  formatted  with  column 
headings.  An  example  is  shown  in  Table  9.  The  files,  SUMPIZ  and  PZTRFL,  are 
replaced  with  new  material  after  every  successful  transfer  of  data  to  the  data 
base.  PIZDAY  is  only  replaced  when  there  is  an  error  message. 

30.  After  the  data  is  successfully  loaded  to  the  data  base  and  the  user 
has  verified  this  by  accessing  either  the  SUMFLE  or  the  data  within  the  data 
base,  the  data  currently  in  DATPIZ  must  be  cleared  and  readied  for  more  data. 
To  accomplish  this,  the  following  command  is  used: 

-CLRPIZ  (for  clear  piezometer) 

Examples 

31.  Example  1 .  The  example  shown  in  Table  10  illustrates  the  data  entry 
program  operation  for  a  new  project,  new  piezometers,  modifying  type  of  oie- 
zometer,  and  readings.  The  long  prompts  are  used  along  with  the  default 
prompt  sequence  for  the  project  data  and  selected  prompts  for  the  piezometer 
information.  A  listing  of  the  data  file  DATPIZ  and  both  the  time  sharing  and 
batch  load  procedures  are  included  in  the  example.  The  cost  of  the  data  entry 
portion  of  this  example  executed  on  the  CDC  computer  was  .<2.20.  The  batch 
loading  costs  about  $1.85. 


Table  10 

Data  Jtotry  Procedures  for  Kev  Project  and  New  Piezometers 


-INPF’IZ 

DO  YOU  WANT  SHORTENED  PROMPTS'?  (v  qR  N' 

7  M 


PIEZOMETER  DATA  ENTRY  SYSTEM 


PROJECT  NAMEdNPUT  END  TO  QUIT)? 

?  MirwAri  kTCiyAw 

IS  this  a  new  PR0JECT?(Y  or  N) 

?  y 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONSt 

1  . . . .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  CREATE  MY  PROMPT  SEQUENCE 

S, .  USE  THE  TAILORED  PROMPT  SEQUENCE 

4 .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


TNPIJT  THE  DESIRED  OPTION 


PROJECT  RIVER'? 

7  1,1  .  p  .  MAWriM  T  WR  R 

'■■ROJECT  STATIC’ 

?  OHIO 

PROJECT  TOWN"? 

7  MAY  I  AMp 

DISTRICT? 

7  r.  r.  H 

TYPE  OF  STRUCTURE'? 

'?  ZO^ED  FAR’H  END 
CREST  ELEVATinN7 
7  1  0  1  1  :  0 

SPILLWAY  ElEVATION? 

7  POT . A 


Vt^auJU  option  voiZt  ask  the  lue/L  ^oH.  alt 
pfLomp;U  ti&ted  In  the  dKonA,  {^Ite,  Table  4 
eitheJi  the  pfiojecZ  vM,  plezometen  level 
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I 


MAXIMUM  POOL  ELEVATION? 

?  1500:0 

1500.000  IS  NOT  WITHIN  THE  LIMITSl  C  980.00  f  1020.00 
MAXIMUM  POOL  ELEVATION?  PfLtiet  MoJbu.  od  tinted  in  Table.  5 

?  1005 !  0 

MINIMUM  POOL  ELEVATION? 

?  951:0 

NORMAL  POOL  ELEVATION? 

?  9S5 :  0 

MAXIMUM  TAILWATER  ELEVATION? 

?  950  :  0 

MINIMUM  TAILWATER  ELEVATION? 

7  935  i  0 

NORMAL  TAILWATER  ELEVATION? 

?  932  :  0 

POOL  OF  RECORD? 

?  959  :  2 

DATE  OF  POOL  RECORD? < MM/DD/YY > 

?  02/01/72 
ALERT  POO’  ? 

?  95®  :  2 

DATE  CONSTRUCTION  BEGAN? ( MM/DD/YY ) 

?  05/01/63 

DATE  CONSTRUCTION  COMPLETED? < MM/DD/YY ) 

?  1 1  /  0 1 . '  6  6 
OREVIEW  OF  INPUT 


NE 

* 

DB  NAME 

DATA  VALUE 

1 

>  9  »  « 

PROJ-NAME 

>  9 

MICHAEL  KIRWAN 

^  «  9  9 

PROJ-RIVER 

9  9 

W.B. MAHONING  R 

3 

•  9  9  9 

PR0J-5TATE 

9  9 

OHIO 

4 

PROJ-TOWN 

9  9 

WAYLAND 

rr 

»  9  9  • 

DIST 

9  • 

PGH 

A 

9  9  9  9 

TYP-STRT 

>  9 

ZONED  EARTH  EMB 

7 

CRT 

>  9 

1011.0 

8 

9  9  9  9 

SPY 

9  < 

993.0 

9 

MXPL 

>  9 

1005.0 

J.O 

9  9  9  9 

MNPL 

»  9 

<551  ,0 

11 

9*99 

NRPL 

9  4 

985.0 

1 2 

>999 

MXTW 

>  9 

950.0 

13 

9  9  9  9 

MNTW 

>  9 

935.0 

14 

9  9  9  9 

NRTW 

9  9 

932.0 

(Continued) 
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15 

....  RECPL 

..  989.2 

16 

. . ♦ .  DRPL 

..  02/01/72 

17 

....  ALTPL 

..  989.2 

18 

....  CONT-BEG 

..  05/01/63 

19 

....  CONT-COM 

..  11/01/66 

OTO  CHANGE  AN  ITEM*  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

Line  numbeA. 

TAILWATER  ELEVATION? 

?  ?30 : 5  Cofuiect  elevation. 

OTO  CHANGE  AN  ITEM?  TYPE  ITS  LINE  ♦ 

OTHERWISE  HIT  RETURN 

7 

0  DO  YOU  WISH  TO  REVIEW  VALUES  AGAIN-^fY  OR  N)*? 
?  Y 


OREVIEW  OF 

INPUT 

L  INE 

* 

DB  NAME 

DATA  VALUE 

1 

PROJ-NAME 

>  ♦ 

MICHAEL  KIRWAN 

o 

PROJ-RIVER 

»  • 

W.B. MAHONING  R 

3 

»  ♦  *  » 

PROJ-STATE 

»  ♦ 

OHIO 

4 

>  ♦  ♦  ♦ 

PROJ-TOWN 

»  9 

WAYLAND 

c; 

>  ♦  ♦  ♦ 

DIST 

>  * 

PGH 

6 

>  •  «  f 

TYP-5TRT 

>  9 

ZONED  EARTH  EMB 

7 

CRT 

>  9 

1011.0 

3 

♦  ♦  «  ♦ 

SPY 

9  9 

993.0 

9 

>  •  «  « 

MXPL 

>  • 

1005.0 

10 

>  «  •  » 

MNPL 

>  9 

951,0 

11 

*  *  f  * 

NR  PL 

9  9 

985.0 

1  2 

>  ♦  ♦  ♦ 

MXTW 

9  9 

950.0 

13 

»  *  *  ♦ 

MNTW 

»  9 

930.5 

lA 

*  ♦  ♦  • 

NRTW 

9  i 

932.0 

15 

»  »  *  « 

RECPL 

*  9 

989.2 

16 

>  f  9  * 

DRPL 

>  9 

02/01/72 

17 

9  *  *  < 

ALTPL 

<  9 

989.2 

18 

*  *  *  * 

cont-beg 

9  9 

05/01/63 

19 

>  •  *  * 

CONT-COM 

>  » 

11/01/66 

OTO  CHANGE 

AN  ITEMf  TYPE 

ITS  LINE  ♦ 

OTHERWISE 

7 

HIT  RETURN 

OPTIONS 

1>,.-  INPUT  NEW  INSTRUMENT 

2...  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 
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I 


3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


PIEZOMETER  OR  GAUGE  NUMBER? 

?  70-C-l 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS! 

1  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  . .  CREATE  MY  PROMPT  SEQUENCE 

3  . .  USE  THE  TAILORED  PROMPT  SEQUENCE 

4  . .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION! 

’  2  cAeote  pfwmpt 

DO  YOU  MEED  THE  PROMPT  LIST?<Y  OR  N> 


C'ROMPTS 

FEATURE  DESCRIPTION?! 10  CHAR.  MAX' 

STATI0N?<8  CHAR,  MAX) 

OFFSET  OR  STATI0N?(8  CHAR,  MAX) 

PIEZOMETER  TIP  ELEVATION'? 

TOP  OF  RISER  OR  GAUGE  ELEVATION? 

GROUND  SURFACE  ELEVATIn-'? 

RISER  PIPE  DIAMETER? 

SOIL  TYPE  AT  TIP?(7  CHAR,  MAX) 

TYPE  OF  P'lEZOMETERTf  20  CHAR.  MAX) 

STATUS  OF  PIEZ0METER?(10  CHAR.  MA''!' 

DATE  OF  INSTALLATION?<:MM/nD/YY) 

LOCATION  OF  INSTALLATION  REPORT?! 10  CHAR.  MAX) 
METHOD  OF  INSTALLATION? f 25  CHAR.  MAX) 

INSTALLED  BY-^dS  CHAR.  MAX) 

METHOD  OF  TESTING'?(15  CHAR.  M.X) 

REFERENCE  DRAWING?  (20  CHAR.  MAX.) 

CALIBRATION  CONSTANT? 

FILTER  MATERIAL'?!  15  CHAR.  MAX- 
TOP  ELEVATION  OF  FILTER? 

BOTTOM  ELEVATION  OF  FILTER'? 


(Continued) 
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41 

42 

43 

44 

45 
A6 

47 

48 
4? 
50 

INPUT 

#•? 

>  2 1 
*•? 


THE 


SEAL  MATERIAL?(15  CHAR.  MAXI 
TOP  ELEVATION  OF  SEAL? 

BOTTOM  ELEVATION  OF  SEAL? 

DATE  OF  LAST  READING? < MM/DD/YY ) 
DATE  OF  NEXT  READING? < MM/DD/YY > 
INTERVAL  BETWEEN  READING?(10  CHAR. 
1ST  THRESHOLD  VALUE? 

2ND  THRESHOLD  VALUE? 

3RD  THRESHOLD  VALUE? 

4TH  THRESHOLD  VALUE? 

PROMPT  NUMBER  (HIT  RETURN  TO  STOP) 


MAX) 


#? 

23 

#? 

*7 

30 

*? 

24 

*? 

tT* 


PfiomptA  numbeA  my  be  atzjuted  out 
oi  sequence. 


?  50 
*? 

7 

DO  YOU  W/M  TO  SAVE  THIS  PROMPT  SEQUENCE? (Y  OR  N) 
THIS  WILL  REPLACE  THE  CURRENT  TAILORED  SEQUENCE 
FOR  PIEZ.  LEVEL  INFORMATION  IF  SAVED 

7  Y 

FEATURE  DESCRIPTION?( 10  CHAP,  MAX) 

7  rMR  . 

STATION? (8  CHAR.  MA") 

7  y»  A  .f  0  0 


Offset  of:  station?(8  char,  max) 

7  15 IJ  /  C 

TYPE  OF  PIEZOMETER? (20  CHAR.  MAX) 

?  OPEN  STANDPIPE 

STATUS  OF  PIEZOMETER?( 10  CHAR,  MAX) 
7  npFP; 
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PIEZOMETER  TIP  ELEVATION? 

?  916>0 

TOP  OF  RISER  OR  GAUGE  ELEVATION? 

7  1015  »0 

4TH  THRESHOLD  VALUE? 

?  0  I  0 

0.000  IS  NOT  WITHIN  THE  LIMITS:  C  850.00  f  1100.00 
4TH  THRESHOLD  VALUE? 

?  1100:00 


OREVIEU  OF 

INPUT 

LINE 

4 

DB  NAME 

DATA  VALUE 

1 

>  4  *  ♦ 

PFD 

>  4 

EMP. 

PSTA 

>  4 

46+00 

3 

4  4  •  • 

POFF 

>  4 

15U/S 

A 

>444 

TYPIEZ 

}  4 

OPEN  STANDPIPE 

5 

>444 

PSAT 

>  4 

OPt:-:. 

6 

4  4  4  4 

TIPEL 

4  4 

936.0 

7 

>  >  4  4 

TREL 

>  > 

1015,0 

R 

4  4  4  4 

PTH4 

>  4 

1100.0 

OTO  CHANGE 

AN  ITEM- 

TYPE 

ITS  LINE  * 

OTHERWISE 

HIT  RETURN 

PATE  OF  READING(  INPUT  11/11/99  TO  QUIT  )(MM/DD/YY.' 
?  09/23/S2 


READING? 

?  45:9 

METHOD  OF  READING?(15  CHAR.  MAX? 

?  TAPE 

PEMARKS?(20  CHAR,  MAX) 

?  NONE 

PATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  10/27/92 


READING? 

?  44:9 

METHOD  OF  READING?(15  CHAR,  MAX) 
?  TAPE 

REMARKS?(20  CHAR,  MAX) 

?  NONE 


(Continued) 
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DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY? 
?  11/11/99 

COLUMNS 


LINE  ♦ 

1 

9 

3 

4 

1 

09/23/82 

45,9 

TAPE 

NONE 

9 

10/27/82 

44.9 

TAPE 

NONE 

TO  CHANGE 

AN  ITEM 

TYPE  ITS 

LINE  NUMBERf  A  COMMA 

AND  ITS  COLUMN  NUMBER  <E.G.  3»2  -  LINE  3  COLUMN 
OTHERWISE  HIT  RETURN 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUl-.'? 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


PIEZOMETER  OR  GAUGE  NUMBER? 

?  29-BC 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS: 

1  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  CREATE  MY  PROMPT  SEQUENCE 

3  .  USE  THE  TAILORED  PROMPT  SEQUENCE 

A  .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 

INPUT  THE  DESIRED  OPTION! 


?  A 

FEATURE  DESCRIPTION?< 10  CHAR,  MAX) 

7  CoMiagt  /leJtuAn  no  d/vtA 

STATI0N?(8  CHAR.  MAX)  U  to  bc  entCACd. 

7  4  A  4. 1  A 

OFFSET  OR  3TATI0N?<:8  CHAR,  MAX) 

?  600D/S 

TYPE  OF  PIEZOMETER? <20  CHAR.  MAX) 

?  GAUGE  ON  STANDPIPE 
STATUS  OF  PIEZ0METER?(10  CHAR,  MAX) 

?  OPER  > 
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•^'lEZOMETER  TIP  ELEVATION? 

?  83® >7 

TOP  OF  RISER  OR  GAUGE  ELEVATION? 

T  Q  A  A  .  A 

4TH  THRESHOLD  VALUE? 


OREVIEW  OF 

INPUT 

LINE  ♦ 

DB  NAME 

DATA  VALUE 

1  »  ♦  ♦  » 

PFD 

>  * 

PSTA 

»  4 

46-s  14 

>  «  «  « 

POFF 

600D/8 

A  »  +  t  * 

TYPIEZ 

>  4 

GAUGE  ON  STANDPIPE 

rr 

J  >  *  «  « 

PSAT 

»  4 

OPER. 

t 

'.•>  «  *  «  « 

TIPEL 

4  ♦ 

838.7 

7  >  ♦  ♦  ♦ 

TREL 

>  4 

944.4 

8  .  *  ♦  ♦ 

PTH4 

>  f 

OTO  CHANGE 
OTHERWISE 

7 

AN  ITEM»  T 
HIT  RETURN 

YPE 

ITS  LINE  ♦ 

DATE  OF  READING(  INPUT  H/11/9?  TO  QUIT  XMM/DD/YY) 
?  09/23/92 


READING? 

?  "5^,76 

METHOD  OF  READING?(15  CHAR.  MAX) 


REMARKS?  <20  CHAR.  M.V- ^ 

7 

DATE  OF  READING< INPUT  U/ll/®9  TO  QUIT  )(MM/DD/YY) 
?  10/27/82 


READING? 

?  34:73 

METHOD  OF  READING?(15  CHAR.  MAX) 

7 

REMARKS? (20  CHAR.  MAX) 

7 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  11/11/99 

(Continued) 
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s 

N 

N 


'J 


COLUMNS 

12  3  ^ 

LINE  # 

1  09/23/S2  5-4,76 

2  10/27/82  54,76 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER^  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G,  3»2  -  LINE  3  COLUMN  2) 
OTHERWISE  HIT  RETURN 


OPTIONS 

1>..  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. ,  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. ,  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


?  1 

PIEZOMETER  OR  GAUGE  NUMBERT 
9  PRECIPi 

please  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS? 

1  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  CREATE  MY  PROMPT  SEQUENCE 

3  .  USE  THE  TAILORED  PROMPT  SEQUENCE 

4  .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 

INPUT  THE  DESIRED  OPTION! 


?  2 

DO  YOU  NEED  THE  PROMPT  LISTTIY  UR  N> 

?  M 

INPUT  THE  PROMPT  NUMBER  (HIT  RETURN  TO  STOP' 

♦  ? 

?  29 

7 

DO  YOU  WANT  TO  SAVE  THIS  PROMPT  SEQUENCE? (Y  OR  N) 
THIS  WILL  REPLACE  THE  CURRENT  TAILORED  SEQUENCE 
FOR  PIEZ.  LEVEL  INFORMATION  IF  SAVED 

7  M 

TYPE  OF  PIE20METER?(20  CHAR.  MAX) 

7  PRECIP: 
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OREVIEU  OF  INPUT 

LINE  ♦  DB  NAME  DATA  VALUE 

1  ....  TYPIEZ  PRECIP. 

OTO  CHANGE  AN  ITEM?  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

7 

DATE  OF  READING( INPUT  11/11/9?  TO  QUIT  )(MM/DD/YY) 
7  09/23/82 


READING? 

7  0 , 1 

HETHOn  OF  READINGTdG  CHAR,  MAX' 

7 

REMARKS? (20  CHAR,  MAX? 

7 

DATE  OF  READIN6< INPUT  11/11/9?  TO  QUIT  >(MM/DD/YY> 

7  11/11/99 

COLUMNS 

12  3  A 

LINE  ♦ 

1  09/23/82  0,1 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER^  A  COMMA 
AND  ITS  COLUMN  NUMBER  <E,G.  3f2  -  LINE  3  COLUMN  2> 
OTHERWISE  HIT  RETURN 

OPTIONS 

1*,,  INPUT  NEW  INSTRUMENT 

2.. ,  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. ,  INPUT  READING  VALUES 

A.,,  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. ,  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


7  1 

PIEZOMEHER  OR  GAUGE  NUMBER? 

7  pnoL 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS? 


1  .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  CREATE  MY  PROMPT  SEQUENCE 

3  USE  THE  TAILORED  PROMPT  SEQUENCE 

4  . .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION* 
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Table  10  (Continued) 


CuAAent  pfLompt  iexiueiULZ.  Xa  the, 
?  ^  ta&t  sequence  u&ed. 

TYPE  OF  PIEZOMETER? <20  CHAR.  MAX) 

?  POOL 

OREVIEW  OF  INPUT 

LINE  ♦  DB  NAME  DATA  VALUE 

1  ....  TYPIEZ  ..  POOL 

OTO  CHANGE  AN  ITEM*  TYPE  ITS  LINE  # 

OTHERWISE  HIT  RETURN 

7 

DATE  OF  READING(  INPUT  11/11/99  TO  CHUT  XMM/DD/YY) 

?  09/2Z/82 


READING? 

?  976,3 

METHOD  OF  READING?<15  CHAR.  MAX) 

7 

REMARKS?<20  CHAR.  MAX) 

7 

DATE  OF  READING! INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

?  1 1  / 1 1  9  9 

COLUMNS 

12  3  A 

LINE  * 

1  09/23/82  976. T 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBERf  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3>2  -  LINE  3  COLUMN  2) 
OTHERWISE  HIT  RETURN 

7 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

A...  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


?  1 

PIEZOMETER  OR  GAUGE  NUMBER? 

7  7  0  -  C  -  2 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS’. 

1  . .  USE  THE  DEFAULT  PROMPT  SEQUENCE 


( Continued ) 
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Table  10  (Continued) 


2  .  CREATE  MY  PROMPT  SEQUENCE 

3  .  USE  THE  TAILORED  PROMPT  SEQUENCE 

4  . .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 

INPUT  THE  DESIRED  OPTION! 


•LEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS: 

:!.  USE  the  default  PROMPT  SEQUENCE 

create  my  prompt  sequence 

USE  THE  tailored  PROMPT  SEQUENCE 
KEEP  THE  CURRENT  PROMPT  SEQUENLU: 


******* 


******* 


INPUT  THE  DESIRED  OP'llON! 


?  U4e  pfiompt  Aequence  cAeatexi  eoAdeA. 

FEATURE  DESCRIPT inM? (10  CHAR.  MAX) 

?  FDN . OB  I 

STATI0NT(8  char.  HA.X) 

?  4  6  E  0  0 

OFf-SET  OR  STATION'!’-' S  CHAR.  MAX) 

'?  1  2  0  n  /  8 

TVPE  OF  PIEZOMETER? TOO  CHAR.  MAX) 

?  Type  0|5  ple.zomeX.eA  omitted 

STATUS  OF  PIEZ0METER?(10  CHAR.  MAX-^ 

?  OPER  ■ 

•"•TE- OMETER  tip  ELEVATION'!' 

'?  Q  O  '■)  ''i 

0  p  n  F  RISE  R  0  R  G  A 1.!  G  E  E I...  E  V  AT]! )  N 

r-  O  yrr^  ,  O 

■Tth  threshold  VALUE'!’ 


OREVIEU  OF  INP!  T 


LINE  f 

DD  NAME 

DATA  VALUE 

•f 

>  ♦  ♦  ♦ 

PFD 

,.  FDN.np. 

>  *  ♦  ♦ 

PST  A 

.  .  4  C'  I'  0  A 

>  *  »  • 

POP  F 

,,  1200/0 

* 

TYPIEZ 

.  • 

,  .  >  ■*  *  f 

PSAT 

. .  OPPR  . 

'i:  .... 

TIPEL 

932.  A 

T  ,  .  ,  . 

TREL 

,,  975. C 

9  .... 

PTH4 

>  ♦ 

OTO  CHANGE 

AN  ITEM? 

TYPE  ITS  LINE  * 

(Continued) 
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Table  10  (Continued) 


OTHERWISE  HIT  RETURN 


the.  tneA  detect  the 
mong  tine  numbefi,  the 
value  mui*  be  fieenteAed 


5.. ,  STATUS  OF  F'IEZ0METER?<  10  CHAR:  MAX? 
?  GPER : 

O-rn  CHANGE  AN  ITEM»  TYPE  ITS  LINE  # 
OTHERWISE  HIT  RETURN 

7  A 

6. .  .PIEZOMETER  TIP  ELEVATION? 

?  92?  :  0 

OK?  CHANGE  AN  ITEM?  TYPE  ITS  LINE  ♦ 
OTHERWISE  HIT  RETURN 


0  DO  YOU  WISH  TO  REVIEW  VALUES  AGAIN? <Y  OR  N)? 

7  /'■  <5  /  7 1  /  o  9 


OREVIEW  OF 

INPUT 

LINE  * 

DD  NAME 

DATA  VALUE 

1  ^  » 

PFD 

>  ♦ 

FDN .OB. 

>  ♦  ♦  ♦ 

PSTA 

>  ♦ 

4  6  T  0  0 

1  :  .  .  . 

POFF 

>  > 

1 20D/S 

■T  .... 

TYPIEZ 

>  > 

KT 

.  )  >  ♦  > 

FSAT 

OPER  : 

6  »  >  ♦  4 

TIPEL 

:  ♦ 

920  >  0 

'  ♦  ♦  ♦  < 

TREL 

♦  ♦ 

975.0 

B  »  4  ♦  . 

PTH4 

>  > 

010  CHANGE 

AN  ITEM 

f  type 

ITS  LINE  t 

UTHERUISE 

HIT  RET 

URN 

7 


■’HE  CURRENT  INSTRUMENT  IS  70~C-2 

rOR  this  piezometer  READING  ARE  '<01,1  ENTERING 

1 . .  , ELEVATION  VALUES 

2.. ,  DEPTH  VALUES  f'ROM  TOP  OR  RISER  IN  r'K 

S,  .  , '"'lEZ  . ’"TP  GAUGE  PRESSURE  f<SI  VALUES 

T,  ,  ,U,P. GAUGE  PRESSURE  PS  I  VALUES 

5  ,  .  ,  0 T 1  i E R  T  Y }■  E  ■: i  -T U 0 E  PRESS U RE  P' S I  V  A L. ! ..! E S 

6.. ,  WATER  LEVEL  GAUGE  READING  IN  FEP-" 

7 ,• .PNEUMATIC  READINGS  IN  PSI 

INPUT  THE  DESIRED  OPTION 


(Continued) 
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Table  10  (Continued) 


?  2 

DATE  OF  READING<INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  09/23/52 


READ  I MG? 

?  >  0 

METHOD  OF  READING?<15  CHAR.  MAX) 

?  TAPE 

REMARKS? (20  CHAR,  MAX) 

?  NOME 

DATE  OF  READING( INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

?  11/11/99 

COLUMNS 

12  3  4 

LINE  t 

1  09/23/82  44,0  TAPE  NONE 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER?  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3?2  -  LINE  3  COLUMN  2) 
OTHERWISE  HIT  RETURN 

? 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMEN-^ 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 


'3,,,  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 

To  add  thz  "TYPE  Of  PIEZOMETER" 
-7  tiAe  the.  option  "MOPIFP  EXISTING 

PIEZOMETER  OR  GAUGE  NUMBER'!*  INSTRUMENT"  pAX>mpt  nwnbeA.  29. 

?  7  0  -  C " 2 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS: 

1  .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  . .  CREATE  MY  PROMPT  SEQUENCE 


3  . .  USE  THE  TAILORED  PROMPT  SEQUENCE 

4  .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION! 


?  2 


(Continued) 
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Table  10  (Continued) 


DO  YOU  NEED  THE  PROMPT  LIST?(Y  OR  N> 

?  N 

INPUT  THE  PROMPT  (-'MBER  (HIT  RETURN  TO  STOP) 

#? 

?  2? 

#? 

v 

DO  YOU  WANT  TO  SAVE  THIS  PROMPT  SEQUENCE? <Y  OR  N> 

THIS  WILL  REPLACE  THE  CURRENT  TAILORED  SEQUENCE 
FOR  PIE2.  LEVEL  INFORMATION  IF  SAVED 
?  N 

TYPE  OF  PIEZ0METER?(20  CHAR.  MAX) 

?  OPEN  STANDPIPE 
OREVIEW  OF  INPUT 

LINE  ♦  DB  NAME  DATA  VALUE 

1  ....  TYPIE2  OPEN  STANDPIPE 

OTO  CHANGE  AN  ITEM.  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

7 

DATE  OF  READING( INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

?  10/25/92 

Since  PZFL  now  contain  TYPE  OF 
PIEZOMETER  ^on  70-C-2,  the  act 

READING?  pKog/uun  uiltt  tmexjLiatzJfy 

7  AA  ,0  p'loceerf  -to  the  datt  oi  xeacUng. 

METHOD  OF  READING? (15  CHAR.  MAX) 

7  TApF 

REMARKS? (20  CHAR.  MAX) 

?  NONE 

DATE  OF  READING( INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

?  1 1  / 1 1  /  9  9 

COLUMNS 

12  3  4 

LINE  # 

1  10/25/82  46.0  TAPE  NONE 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER.  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3.2  -  LINE  3  COLUMN  2) 
OTHERWISE  HIT  RETURN 

7 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 


(Continued) 
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Table  10  (Concluded) 


4.. .  BE  PROMPTED  F0»  SETS  OF  RF.ADING5 

5.. .  NO  MORE  INSTRUMENTS  TO  EN-ER 
INPUT  THE  DESIRED  OPTION 


?  5 

PROJECT  NAME (INPUT  END  TO  QUIT)? 
?  END 

DATA  ENTRY  TERMINATED 


LUtuig  oi  douta  iiJU.  DATPJZ. 

PIEZ  LOAD  DATA  FILE 

PPOJIOIYHICHAEL  KIRUAN  H.B.HAHOMINO  R 

PR0J102  OHIO  HAXLAND  P6H  ZONED  EARTH  END  99/01/A3  il/Ot/U 

PR0J1031011, 0993.0  1005.09S1.0  98S.0  9S0.0  930.5  932.0  9S9.2  04/01/72  9D9.2 


PIE211170-C-1 

ENB.  44400  ISU/S 

PIEZ11270-C-1 

P1E211370-C-1 

PIE211470-C-1 

PtEZ11070-C-l 

OPEN  STANDPIPE 

1015.0936.0 

OPER. 

P1EZ11570-C-1 

09/23/8245.9  TAPE 

NONE 

2 

PIEZ11570-C-1 

10/27/8244.9  TAPE 

NONE 

2 

PIEZIU29-BC 

40414  AOOD/S 

P1EZH229-BC 

PIEZli329-BC 

PIEZU429-BC 

OAUOE  ON  STANDPIPE 

944.4  838.7 

OPER. 

PIEZ11029-BC 

PIEZ11S29-BC 

09/23/8254.70 

5 

PIEZUS29-BC 

10/27/8254.70 

5 

PIEZlllPRECIP. 

PIEZ112PRECIP. 

PRECIP. 

P1EZU3PRECIP. 

PIEZ114PRECIP. 

PIEZllOPRECIP, 

PIEZ115PRECIP. 

PIEZlllPOOL 

09/23/820.1 

1 

PIEZllZPOOL 

PIEZ113P00L 

POOL 

riEZ114P00L 

PIEZllOPOOL 

PlEZllSPOOL 

09/23/82976.3 

1 

PIEZl J170-C-2 
‘'IE:11270-C-2 
PIEZ11370-C-2 
PIEZ11470-C-2 

FDN.OB.  46+00  120D/S 

975.8  978.0 

OPER. 

PIEZ11070-C-2 

PIEZ11570-C-2 

09/23/8244.0  TAPE 

NONE 

2 

PIEZ11170-C-2 

PIE211270-C-2 

OPEN  STANDPIPE 

PIE211370-C-2 

PIEZ11470-C-2 

PIEZ11070-C-2 

PIEZU570-C-2 

10/25/8240.00  TAPE 

NONE 

2 

32.  Example  2.  This  example,  shown  In  Table  11,  Illustrates  the  data 
entr7  program  operation  for  existing  projects  and  piezometers.  The  long 
prompts  are  used  for  clarity.  The  usage  of  both  the  project  and  piezometer 
modification  options  and  the  reading  value  options  are  shown.  The  second 
project  Illustrates  the  prompting  by  Instrument  name  option.  The  listing  of 
DATPIZ  Is  included.  The  cost  for  this  data  entry  session  on  the  CDC  computer 
was  $2.02. 


Table  11 


i 


Data  Entry  Procedure  for  Existing  Pro.lect  and  PlezometerB  (Example  2) 


-INPPI2 

DO  YOU  WANT  SHORTENED  PROHPTSTCY  OR  N> 
?  N 


PIEZOMETER  DATA  ENTRY  SYSTEM 


PROJECT  NAME< INPUT  END  TO  QUIT)? 

?  KICHAEL  KIRUAN 
IS  THIS  A  NEW  PROJECT?<Y  OR  N> 

?  N 

PROJECT  KICHAEL  KIRWAN 
DOES  NOT  EXIST!  TRY  AGAIN 
PROJECT  NAMEdNPUT  END  TO  QUIT)? 

?  MICHAEL  KIRWAN 
IS  THIS  A  NEW  PROJECT?<Y  OR  N) 

?  N 

DO  YOU  NEED  TO  MODIFY  PROJECT  DATA?<Y  OR  N) 
?  Y 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS: 


1  .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  CREATE  MY  PROMPT  SEQUENCE 

3, .  USE  THE  TAILORED  PROMPT  SEQUENCE 

. .  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION 


Tht  cotZtction  pfiogfum  loitt 
veAl^y  the.  cjofuvejct  pnose/et 
OK  piezometeK  nam&s. 


7  ,  CKeate  pKompt  to  modiiif  the  pKoject  data. 

DO  YOU  NEED  THE  PROMPT  LIST?<Y  OR  N) 


?  Y 

NO.  PROMPTS 

2  .  PROJECT  RIVER? 

3  . . .  PROJECT  STATE? 

4  .  PROJECT  TOWN? 

5  .  DISTRICT? 

6  .  TYPE  OF  STRUCTURE? 

7  .  CREST  ELEVATION? 

8  .  SPILLWAY  ELEVATION? 

(Contiuucd) 
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Table  11  (Continued) 


9  .  HAXIMUH  POOL  ELEVATION? 

10  .  NINIHUM  POOL  ELEVATION? 

11  .  NORHAL  POOL  ELEVATION? 

12  .  MAXIHUH  TAILUATER  ELEVATION? 

13  .  NINIHUH  TAILUATER  ELEVATION? 

14  .  NORHAL  TAILUATER  ELEVATION? 

15  .  POOL  OF  RECORD? 

16  .  DATE  OF  POOL  RECORD?  ( HH/DD/YY ) 

17  .  ALERT  POOL? 

18  .  DATE  CONSTRUCTION  BEGAN? (HH/DD/YY) 

19  .  DATE  CONSTRUCTION  COHPLETED?(HH/DD/YY) 

INPUT  THE  PROHPT  NUHBER  (HIT  RETURN  TO  STOP) 

#? 

7  14  The.  datx  beue  value,  to  be  changed 

#7  Za  nonmaJi  taJUbMtXK  eJtzvation, 

7 


DO  YOU  UANT  TO  SAVE  THIS  PROHPT  SEQUENCE(Y  OR  N) 

THIS  UILL  REPLACE  THE  CURRENT  TAILORED  PROHPT  SEQUENCE 
FOR  PROJECT  LEVEL  INFORHATION  IF  SAVED 
?  N 

NORHAL  TAILUATER  ELEVATION?  The.  coHMJcJt  eZex/atton  that  uUlt 
?  935  >0  Keptaoe  the.  one  in  the  data  ba&e. 

OREVIEU  OF  INPUT 

LINE  *  DB  NAHE  DATA  VALUE 

1  PROJ-NAHE  ..  HICHAEL  KIRUAN 

2  NRTW  ..  935.0 

OTO  CHANGE  AN  ITEH»  TYPE  ITS  LINE  # 

OTHERUISE  HIT  RETURN 

7 

OPTIONS 

1.. .  INPUT  NEU  INSTRUHENT 

2.. .  HODIFY  EXISTING  INSTRUHENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROHPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


f«Odliy  dotU  VOtue  AA 

^PIEZOMETER  OR  GAUGE  NUMBER?  p^UzomUdA  70-C-U 

PLEASE  SELECT  ONE  OF  THE  FOLLOUING  OPTIONS: 

1  .  USE  THE  DEFAULT  PROHPT  SEQUENCE 

2  .  CREATE  HY  PROMPT  SEQUENCE 

3  .  USE  THE  TAILORED  PROHPT  SEQUENCE 

4  .  KEEP  THE  CURRENT  PROHPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION! 


(Continued) 
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Table  11  (C<»xtinued) 


?  2 

DO  YOU  NEED  THE  PROMPT  LIST?<Y  OR  N) 


?  Y 

NO,  PROMPTS 

21  .  FEATURE  DESCRIPTION?( 10  CHAR*  MAX) 

22  .  STATI0N?(8  CHAR.  MAX) 

23  .  OFFSET  OR  STATZ0N?(8  CHAR.  MAX) 

24  .  PIEZOMETER  TIP  ELEVATION? 

25  .  TOP  OF  RISER  OR  GAUGE  ELEVATION? 

26  .  GROUND  SURFACE  ELEVATION? 

27  .  RISER  PIPE  DIAMETER? 

28  .  SOIL  TYPE  AT  TIP?(7  CHAR.  MAX) 

29  ........  TYPE  OF  PIEZ0METER?(20  CHAR*  MAX) 

30  .  STATUS  OF  PIEZOMETER?< 10  CHAR.  MAX) 

31  .  DATE  OF  INSTALLATION?(MM/DD/YY) 

32  .  LOCATION  OF  INSTALLATION  REP0RT?(10  CHAR*  MAX) 

33  .  METHOD  OF  INSTALLATION?( 25  CHAR.  MAX) 

34  .  INSTALLED  BY?(15  CHAR.  MAX) 

35  .  METHOD  OF  TESTING?(15  CHAR.  MAX) 

36  .  REFERENCE  DRAWING?  (20  CHAR.  MAX.) 

37  ........  CALIBRATION  CONSTANT? 

38  .  FILTER  MATERIAL?(15  CHAR.  MAX) 

39  .  TOP  ELEVATION  OF  FILTER? 

40  .  BOTTOM  ELEVATION  OF  FILTER? 

41  .  SEAL  MATERIAL?(15  CHAR.  MAX) 

42  .  TOP  ELEVATION  OF  SEAL? 

43  .  BOTTOM  ELEVATION  OF  SEAL? 

44  .  DATE  OF  LAST  READING? ( MM/DD/YY ) 

45  .  DATE  OF  NEXT  READING? <  MM/DD/YY ) 

46  .  INTERVAL  BETWEEN  READIN6?(10  CHAR.  MAX) 

47  .  1ST  THRESHOLD  VALUE? 

48  .  2ND  THRESHOLD  VALUE? 

49  .  3RD  THRESHOLD  VALUE? 

50  .  4TH  THRESHOLD  VALUE? 

INPUT  THE  PROMPT  NUMBER  (HIT  RETURN  TO  STOP) 

♦  ? 

7  30  To  update,  the.  Atatud  the 

|!7  ptezometea. 


DO  YOU  WANT  TO  SAVE  THIS  PROMPT  SEQUENCE?(Y  OR  N) 

THIS  WILL  REPLACE  THE  CURRENT  TAILORED  SEQUENCE 
FOR  PIEZ.  LEVEL  INFORMATION  IF  SAVED 
?  N 

STATUS  OF  PIEZ0METER?(10  CHAR.  MAX) 

?  INOPER, 

OREVIEW  OF  INPUT 

LINE  *  DB  NAME  DATA  VALUE 

1  ....  PSAT  ..  INOPER. 

(continued)  3  j  , 


Table  11  (Continued) 


OTO  CHANGE  AN  ITEMt  TYPE  ITS  LINE  * 

OTHERWISE  HIT  RETURN 

? 

DATE  OF  READIN6< INPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

^  OPTIONS^  could  be  enteAed. 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 

Continue,  to  enten.  AeadinQi  io>L  otheA 
7  3  pie.zometeA6 . 

PIEZOMETER  OR  GAUGE  NUMBER? 

?  70-C-2 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  >(MM/DD/YY) 
?  12/23/82 


READING? 

?  43.80 

METHOD  OF  READING?<15  CHAR.  MAX) 

?  TAPE 

REMARKS?<20  CHAR.  MAX) 

?  NONE 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 

?  11/11/99 

COLUMNS 

12  3  4 

LINE  t 

1  12/23/82  43.80  TAPE  NONE 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUHBERf  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3f2  -  LINE  3  COLUMN  2) 

OTHERWISE  HIT  RETURN 

7 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 

Thi&  option  i6  moAt  udcfuC  when  alt  the  in&tAunent  inionmtion 
7  4  hoA  been  enteAed  and  the  uJAeA  needi  to  enteA  only  the  Aeading 
yfoluiei  ^oA  all  plezometeu  taken  on  the  Aome  date. 


(Continued) 
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Table  11  (Continued) 


WILL  PROMPT  BY  PIEZOMETER  NOW 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  01/23/83 


READING  FOR  70-C-l 


READING  FOR  70-C-2 
?  45.2 

METHOD  OF  READINGTdS  CHAR.  MAX) 

9 

REMARKS? (20  CHAR.  MAX) 

9 


(RETURN  IF  NONE  /  END  TO  QUIT)? 
No  Aeadbig  ,Atutfumtint  inopejuitu/t. 


(RETURN  IF  NONE  /  END  TO  QUIT)? 


READING  FOR  70-C-3 
?  52,1 

METHOD  OF  READIN0?(1S  CHAR.  MAX) 

? 

REMARKS?(20  CHAR.  MAX) 

9 


(RETURN  IF  NONE  /  END  TO  QUIT)? 


r-: 

iT*. 

A 


READING  FOR  70-C-4 
?  43,5 

METHOD  OF  READING?(1S  CHAR.  MAX) 

9 

REMARKS?(20  CHAR.  MAX) 

9 


(RETURN  IF  NONE  /  END  TO  QUIT)? 


READING  FOR  POOL 


READING  FOR  PRECIP. 

?  ,2 

METHOD  OF  READIN6?(15  CHAR.  MAX) 

9 

REMARKS?(20  CHAR.  MAX) 

9 


(RETURN  IF  NONE  /  END  TO  QUIT)? 
No  fLzatUjnQ  to  e/iteA^not  taken 
on  DI/23/83. 

(RETURN  IF  NONE  /  END  TO  QUIT)? 


(Continued) 
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Table  11  (Continued) 


READING  FOR  70-C-5  (RETURN  IF  NONE  /  END  TO  QUIT)? 

UAe/i  may  continue,  to  enteA.  reading  vaiuei 
^OA.  att  exciting  piezomete/u. 


COLUMNS 

1 

2 

3 

4  5 

LINE  * 

1  01/23/83 

45.2 

70-C-2 

2  01/23/83 

52.1 

70-C-3 

3  01/23/83 

43.5 

70-C-4 

4  01/23/83 

.2 

PRECIP 

TO  CHANGE  AN  ITEM 

TYPE  ITS  LINE 

NUMBER f  A  COMMA 

AND  ITS  COLUMN  NUMBER  (E.6.  3i2 

-  LINE  3  COLUMN  2) 

OTHERWISE  HIT  RETURN 


PROJECT  NAHE( INPUT  END  TO  QUIT)? 
?  TIONESTA  LAKE 

IS  THIS  A  NEW  PROJECT?(Y  OR  N) 

?  N 


When  att  deiced  fieading& 
have  been  entered  tthe 
uieA.  can  move  on  to  the 
neat  project. 


DO  YOU  NEED  TO  MODIFY  PROJECT  DATA?(Y  OR  N) 

?  N 

OPTIONS 

!,.♦  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

A,*,  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


?  3 

PIEZOMETER  OR  GAUGE  NUMBER? 

?  78-T-l 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  42,5 

SORRYf  THE  DATE  IS  NOT  IN  THE  CORRECT  FORMAT 

Cottect  pAogfum  editing  capabititeA, 

DATE  OF  READINGCINPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 
?  12/23/82 


READING? 

?  42,5 

(Continued) 
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Table  11  (Continued) 


METHOD  OF  READING?<15  CHAR.  MAX) 

7 

REMARKS?<20  CHAR.  MAX) 


7 

DATE  OF  READINGdNPUT  11/11/99  TO  QUIT  )(MM/DD/YY) 


?  11/11/99 

COLUMNS 

1 

2 

3 

4 

LINE  ♦ 

1  12/23/82 

42.5 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER»  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3f2  -  LINE  3  COLUMN  2) 
OTHERWISE  HIT  RETURN 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


?  5 

PROJECT  NAME< INPUT  END  TO  QUIT)? 
?  END 

DATA  ENTRY  TERMINATED 


(Continued) 
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Table  11  (Concluded) 


OLDrDATPIZ 

/LIST 

PIEZ  LOAD  DATA  FILE 

PROJIOINHICHAEL  KIRUAN 

PR0J102 

PR0J103 

PIEZ11170-C-1 

PIEZ11270-C-1 

PIEZn370-C-l 

PIEZn470-C-l 

PIEZI1070-C-1 

PIEZ11570-C-2  12/23 

PIEZ11S70-C-2  01/23 

PIEZ11570-C-3  01/23 

PIEZ11570-C-4  01/23 

P1EZ115PRECIP.  01/23 


INOPER. 


12/23/8243.80  TAPE 

01/23/8345.2 

01/23/8352.1 

01/23/8343.5 

01/23/83.2 


PROJIOINTIONESTA  LAKE 
P1EZ11S78-T-1  12/23/0242. 5 
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33.  Example  3.  This  example,  shown  in  Table  12,  illustrates  the  use  of 
the  shortened  prompts  to  enter  piezometer  data  and  reading  values  for  an 
existing  project.  The  prompt  sequence  selected  in  example  1  is  used  to  enter 
the  piezometer  data.  The  user  should  become  familiar  with  the  data  entry 
program  before  using  this  option.  The  cost  of  this  session  was  $1.20. 


Table  12 


Data  Eatry  Procedure  vlth  Shortened  Prompts  (Example  3) 


-IHPPIZ 

DO  Vbu'wANT  SHORTENED  PROMPTS? <Y  OR  N) 
?  Y 


PIEZOMETER  DATA  ENTRY  SYSTEM 


PRNAM^  Tab-E-C  4» 

?  MICHAEL  KIRMAN 
IS  THIS  A  NEW  PR0JECT?(Y  OR  N) 

?  N 

DO  YOU  NEED  TO  MODIFY  PROJECT  DATA?<Y  OR  N) 

?  M 

OPTIONS 

1,*.  INPUT  NEW  INSTRUMENT 

2,..  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 
3«..  INPUT  READING  VALUES 
A,,,  BE  PROMPTED  FOR  SETS  OF  READINGS 
5»..  NO  MORE  INSTRUMENTS  TO  ENTER 
INPUT  THE  DESIRED  OPTION 


?  1 
PIZNM 
?  T  !  W  : 

PLEASE  SELECT  ONE  OF  THE  FOLLOWING  OPTIONS; 


1  . . . .  USE  THE  DEFAULT  PROMPT  SEQUENCE 

2  .  CREATE  MY  PROMPT  SEQUENCE 

3  .  USE  THE  TAILORED  PROMPT  SEQUENCE 

A  KEEP  THE  CURRENT  PROMPT  SEQUENCE 


INPUT  THE  DESIRED  OPTION! 


?  3 

FEATRE 
?  N/A 
STAT 
?  N/A 
OFFSET 
?  N/A 


CouM  cUUo  u6e  option  Z  to  eZiininatz. 
unmnted  pAompti. 


(Continued) 
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Table  12  (Continued) 


TIPEL 
?  0:0 
TOR 

?  927:0 
PIZTYP 
?  T:M. 

PZSTAT 

7 

THRSH4 

7 

OREVIEW  OF  INPUT 
LINE  *  DB  NA 


DB  NAME 

DATA  VALUE 

PFD 

>  * 

N/A 

PSTA 

>  4 

N/A 

POFF 

t  # 

N/A 

TIPEL 

«  4 

0»0 

TREL 

»  4 

927,0 

TYPIEZ 

PSAT 

PTH4 

4  4 

4  4 

4  4 

T.W, 

AN  ITEM.  TYPE 
HIT  RETURN 

ITS  LINE  ♦ 

RDGDAT 

7  nQ/OT/lOP*? 


READING? 

7  929  : 9 
RD6MET 

7 

REMARK 

7 

RDGDAT 

7  10/'77/P'3 


READING? 

7  929:0 
RDGMET 

7 

REMARK 

7 

RDGDAT 

7  11/11/9? 


The  ihofUmed  pfwmpti  option  dou  not 
pfUnt  out  the  fiequAAed  ^oAmt  ^oa.  input 
data,m/VDiyy. 


(Continued) 
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Table  12  (Continued) 


.1 


COLUMNS 


LINE  * 


Ne.ti  to  co^ect  the.  date,. 


1  09/23/19  929.9  Heext  to  coAAect  tne  oo; 

2  10/27/82  929.0 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBERf  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3f2  -  LINE  3  COLUMN  2> 
OTHERWISE  HIT  RETURN 
?  1.1 

RD6DAT 
?  09/23/82 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBERr  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3.2  -  LINE  3  COLUMN  2> 
OTHERWISE  HIT  RETURN 


ODD  YOU  WISH  TO  REVIEW  VALUES  AGAIN?  (Y  OR  N) 


COLUMNS 


LINE  * 
1 


1  09/23/82  929.9 

2  10/27/82  929.0 

TO  CHANGE  AN  ITEM  TYPE  ITS  LINE  NUMBER.  A  COMMA 
AND  ITS  COLUMN  NUMBER  (E.G.  3.2  -  LINE  3  COLUMN  2> 
OTHERWISE  HIT  RETURN 


ODO  YOU  WISH  TO  REVIEW  VALUES  AGAIN?  (Y  OR  N) 


?  M 

OPTIONS 

1.. .  INPUT  NEW  INSTRUMENT 

2.. .  MODIFY  EXISTING  INSTRUMENT/DATA  VALUES 

3.. .  INPUT  READING  VALUES 

4.. .  BE  PROMPTED  FOR  SETS  OF  READINGS 

5.. .  NO  MORE  INSTRUMENTS  TO  ENTER 


INPUT  THE  DESIRED  OPTION 


PRNAME 
?  END 

DATA  ENTRY  TERMINATED 


(Continued) 
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Table  12  (Concluded) 


■OLSfBATPIZ 

/LIST 

PIEZ  LOAD  DATA  FILE 
FROJIOINNICHAEL  KIRUAN 
PIEZtllT.U.  N/A  N/A  N/A 

PIEZ112T.U.  T.U. 

PIEZ113T.U. 

PIEZ114T.U. 

PIEZllOT.y. 

PIEZllST.U.  09/23/82929.9  4 

PIEZ113T.U.  10/27/82929.0  4 


PART  IV;  DATA  OUTPUT 


34.  The  primary  justification  for  using  a  data  base  management  system  Is 
the  flexible  retrieval  capability.  System  2000  offers  three  methods  of  re¬ 
trieving  data:  natural  language.  Report  Writer,  and  procedural  language 
Interface  (PLI).  The  natural  language  allows  the  user  to  browse  or  retrieve 
data  by  asking  questions  using  the  built-in  system  query  language  (Intel  Corp. 
1981a).  This  Is  the  simplest  and  most  flexible  of  the  three  retrievals  because 
the  user  asks  for  the  needed  Information  during  a  time-sharing  session.  Each 
query  or  question  requires  a  scan  of  the  data  base  files.  The  report  writer 
capability  allows  for  the  rapid  retrieval  of  formatted  reports  from  a  single 
scan  of  the  data  base  files  (Intel  Corp.  1981b).  The  reports  can  be  developed 
Interactively  while  using  System  2000  (expensive)  or  separately  from  the  data 
base  using  GENIUS  to  quickly  build  a  file  that  Is  Invoked  when  using  the  data 
base  (Intel  Corp.  1982).  The  report  writer  requires  the  user  to  have  some 
knowledge  of  the  data  base  query  language  plus  the  report  writer  features. 

The  PLI  retrievals  are  program  statements  containing  FORTRAN  programs  that 
Interface  with  the  data  base  to  gather  data  required  by  the  program  (Intel 
Corp.  1983).  Some  computer  programming  experience  Is  required  to  generate 
these  programs,  but  once  written,  the  programs  are  easy  to  use.  The  next 
sections  will  describe  the  natural  language  retrieval  methods,  the  interactive 
data  modification  procedure,  the  use  of  string  retrievals.  Report  Writer 
retrievals,  and  the  graphic  output  programs.  At  this  time,  there  are  no  PLI 
output  programs  developed.  All  the  data  base  element  names  and  component 
numbers  used  in  the  examples  are  described  In  Table  1. 

Data  Base  Access 


35.  A  procedure  file  called  GETDB  is  available  to  access  the  S2K  data 
base.  The  commands  used  in  this  file  are  shown  below; 

GET,S2KGET/UN=CECE2K. 

CALL,S2KGET. 

S2K. 


To  use  this  procedure  to  access  S2K  data  base,  the  following  command  Is  used 
which  win  result  In  the  computer  response  shown  (Note:  The  slash  (/)  Is  the 
computer  command  level  prompt  requesting  user  Input.  The  question  mark  (?)  Is 
the  data  base  prompt  requesting  user  Input.) 

-GETDB 

''S2K  2.80F'' 

84/04/06,  10.09.06.  BEGIN  SYSTEM  2000  VERSION  2.80F 

The  user  Is  now  In  the  System  2000  shell  and  must  specify  a  password  and  data 
base  name  to  access  a  particular  data  base.  For  the  piezometer  data  base,  the 
name  Is  PIEZDB.  Data  bases  can  be  accessed  In  two  modes.  The  first  mode, 
data  base  name  (DBN  mode),  allows  only  one  user  to  access  the  data  base 
at  a  time.  This  mode  must  be  used  if  data  will  be  entered  or  modified. 

The  second  mode  is  the  shared  mode  (SHARED  DBN)  which  allows  several  Indi¬ 
viduals  to  access  the  data  at  once.  In  this  mode  only  data  retrievals  are 
allowed.  The  following  Illustrates  the  first  mode: 

USER, XXX ;0BN  IS  PIEZDB; 

-556-  ASSIGNED  PIEZDB  1  65  84/03/28.  11.48.23. 


The  three-character  password  can  be  established  In  accordance  with  the  user 
specifications. 

36.  System  2000  allows  commands  to  be  entered  on  multiple  lines  from  the 
user's  time-sharing  terminal.  All  data  base  commands  must  end  in  a  semicolon 
(;).  The  system  will  not  execute  any  command  until  the  semicolon  Is 
encountered.  If  multiple  lines  are  used  to  input  a  command,  always  type  a 
space  at  the  beginning  of  each  additional  line. 

37.  When  the  user  has  finished  working  in  the  data  base,  the  following 
command  will  close  the  data  base  and  place  the  user  in  the  computer  command 
mode  (slash  prompt): 


EXIT; 


70 


The  following  response  will  occur 


-506-  CLOSED  PIEZDB  1  65  84/03/28.  11.48.23. 

84/04/06.  10.08.51.  END  SYSTEM  2000  VERSION  2.80F 
STOP  S2K 


If  the  above  command  does  not  work  the  first  time,  the  following  will  always 
work: 


;  EXIT; 

If  a  query  or  command  produces  an  unwanted  listing,  the  user  can  sometimes 
stop  the  printing  by  using  the  "Break"  or  Interrupt"  key  on  the  terminal. 

38.  The  data  accessed  by  the  System  2000  program  reside  in  six  direct 
access  files.  The  files  names  are  determined  by  the  data  base  name,  thus  for 
the  piezometer  data  base  name  of  PIEZDB,  the  six  files  are  TALPLAK,  T6LPLAK, 
TCLPLAK,  TOLPLAK,  TELPLAK,  and  TFLPLAK. 

Output  Files 

39.  Sometimes  the  user  would  like  to  save  some  of  the  data  base  output 
in  the  computer  files  for  future  analysis  or  reference.  This  can  be  done  by 
directing  the  output  of  a  report  file.  This  feature  of  the  data  base  is  very 
important  when  the  user  wants  to  generate  graphic  plots.  Normally  the  report 
file,  which  will  contain  the  results  from  the  user's  queries,  is  assigned  to 
OUTPUT,  which  is  the  user's  teletype  terminal.  However,  the  user  can  assign 
the  results  to  an  output  file  which  can  then  be  saved.  The  following  sequence 
of  commands  is  used: 

REPORT  FILE  IS  OUTl; 

"Natural  language  Retrieval  or  Report  Writer  Commands" 

REPORT  FILE  IS  OUTPUT; 


In  this  example  the  natural  language  retrieval  or  Report  Writer  output  would 
be  sent  to  file  OUTl.  The  last  statement  returns  the  output  to  the  user's 
terminal  for  any  other  commands.  After  the  user  has  exited  from  the  data 
base,  the  following  command  is  used  to  make  the  output  file  permanent: 

SAVE, OUTl 

The  file  OUTl  is  then  accessed  like  apy  other  file  on  the  CDC  computer. 

Natural  Language  Retrievals 


Description 

40.  The  natural  language  retrievals  are  designed  to  allow  the  user  to 
browse  through  or  retrieve  data.  These  retrievals  are  generally  simple  re¬ 
quests  that  the  user  initiates  during  a  time-sharing  session.  Some  requests 
can  become  complicated  with  titles  and  paging  information,  but  the  costs  of 
these  requests  generally  dictate  that  the  Report  Writer  be  used.  To  facilitate 
this  feature  of  the  data  base,  a  query  language  has  been  developed  that  con¬ 
tains  certain  commands,  clauses,  and  operators  the  data  base  understands.  The 
following  discussion  of  the  query  language  is  not  an  exhaustive  reference,  but 
various  components  are  described  that  are  used  with  this  particular  data  base 
so  that  a  user  can  interrogate  this  system.  The  user  is  referred  to  the 
System  2000  QUEST  Manual  (Intel  Corp.  1981a)  for  more  detailed  information  on 
the  query  language.  All  data  base  element  names  and  component  numbers  used  in 
the  example  in  this  section  are  described  in  Table  1. 

41.  The  general  format  for  natural  language  retrievals  is 

COMMAND  OBJECT  LIST  WHERE  CLAUSE 

OR  AND 

ACTION  VERB  OPERATORS 

The  two  principal  action  verbs  are  PRINT  and  LIST.  The  object  list  consists 
of  the  desired  items  of  interest  such  as  specific  element  names,  component 
numbers,  repeating  groups,  and  system  functions  like  MAXIMUM,  MINIMUM,  SUM, 
and  COUNT.  The  components  in  the  object  list  may  be  KEY  or  NON-KEY  elements. 


The  user  can  use  either  component  numbers  or  element  names  Interchangeably  as 
Item  identifiers;  however,  it  is  more  cost  efficient  to  use  one  or  the  other. 
The  WHERE  clause  defines  conditions  which  must  be  satisfied  before  a  retrieval 
or  updating  operation  will  be  performed.  The  variables  used  in  the  WHERE 
clause  must  be  KEY  variables  and  members  of  the  sane  repeating  group  as  the 
elements  in  the  object  list. 

PRINT  command. 

The  PRINT  command  allows  the  user  to  print  any  data  from  the  data 
base  in  a  sequential  vertical  list.  Two  examples  would  be: 

PRINT  PIEZ; 

PRINT  PIEZ  WHERE  PROJ-NAME  EQ  MICHAEL  KIRWAN; 

The  first  request  will  print  all  the  data  for  all  piezometers 
while  the  second  request  will  print  all  the  data  for  just  the 
MICHAEL  KIRWAN  project.  Besides  requesting  data  by  repeating 
groups,  individual  data  elements  (Identified  by  data  element 
name  or  component  number)  can  be  used  as  the  following  example 
illustrates: 

PRINT  PNO,PSTA,POFF,TIPEL  WHERE  PROJ-NAME  EQ  MICHAEL  KIRWAN; 

or  by  using  a  component  number 

PRINT  C41,C45,C47,C49  WHERE  Cl  EQ  MICHAa  KIRWAN; 

This  example  would  print  the  piezometer  number,  station,  offset, 
and  tip  elevation  for  all  piezometers  associated  with  the  MICHAEL 
KIRWAN  project.  The  print  command  lists  one  data  item  with  the 
data  base  component  number  per  line.  The  data  element  name  can 
be  printed  instead  of  the  component  number  by  using  NAME  option 
as  shown  in  the  following  example  which  produces  the  same  result 
as  the  previous  example  except  that  the  element  names  are  printed 
with  the  data  instead  of  the  component  number: 

PRINT/NAME/C41,PSTA,P0FF,TIPEL  WHERE  Cl  EQ  MICHAEL  KIRWAN; 

Other  examples  of  format  control  are  discussed  under  "Format 
option",  PRINT  statements  can  be  used  with  any  correct  WHERE 
clause,  ORDERING  clause,  and  BY  lists.  Examples  of  these  will  be 
shown  when  they  are  described  later  in  this  section, 

LIST  command, 

nr  The  LIST  command  is  similar  to  the  print  command  except  that  the  data 
values  are  spread  across  the  page  in  a  tabular  format  with  the  data  element 
name  at  the  top  of  each  column.  Several  examples  of  LIST  commands  are: 


LIST  Cl,  PNO.PFD.TYPIEZ; 

LIST  PNO,PFD,TYPIEZ  WHERE  Cl  EQ  MICHAEL  KIRWAN; 

LIST  C41,  PFD,C59  WHERE  Cl  EQ  MICHAEL  KIRWAN; 

LIST  C41,C43,C59  WHERE  Cl  EQ  MICHAEL  KIRWAN*. 

The  first  request  would  list  the  project  name,  piezometer  name, 
feature  description,  and  type  of  piezometer  for  all  projects  in 
the  data  base.  The  other  commands  would  retrieve  data  only  for 
the  MICHAEL  KIRWAN  project.  The  output  from  the  second,  third, 
and  fourth  examples  are  the  same.  The  third  example  where 
component  numbers  and  element  names  are  intermixed  in  the  object 
list  is  less  efficient  and  costlier  than  the  second  or  fourth 
example.  As  with  the  PRINT  command,  the  LIST  command  can  be 
used  with  WHERE  clauses,  ORDERING  clauses,  and  BY  lists.  Exam¬ 
ples  will  be  shown  when  they  are  described  later  in  the 
section.  In  addition,  with  the  LIST  command,  titles,  page 
headings,  and  footnotes  can  be  added  to  the  output  along  with 
fonnattinq  where  the  data  appear  on  the  page.  These  options 
dealing  with  page  formatting  will  be  described  in  the  paragraph 
"Formatted  LIST  commands." 

WHERE  clause. 

44.  The  WHERE  clause  specifies  conditions  which  must  be  true  before 
retrieval  or  updating  operation  can  occur.  The  clauses  consist  of  a  series 
of  phases  that  contain  either  the  component  number  or  element  name,  an 
operator,  and  the  value  or  condition.  The  following  are  examples  of  the 
different  types  of  operators  that  are  available: 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


LIST  C41  WHERE 


Cl  EQ  MICHAEL  KIRWAN;  (select  piezometer  names 

for  one  project), 

C49  EQ  300.0;  (select  piezometer  names  for  all 

tip  elevations  equal  to  300  ft). 

C59  FAILS;  (select  piezometer  names  where  there 
is  no  entry  for  type  of  piezometer). 

C59  EXISTS;  (select  piezometer  names  where  there 
is  an  entry  for  type  of  piezometer). 

C49  GT  300.0;  (select  piezometer  names  for  all 
tip  elevations  greater  than 
300  ft). 

C49  GE  300,0;  (select  piezometer  names  for  all 
tip  elevations  qreater  than  or 
equal  to  300  ft). 

C49  LT  300.0;  (select  piezometer  names  for  all 

tip  elevations  less  than  300  ft). 

C49  LE  300.0;  (select  piezometer  names  for  all 

tip  elevations  less  than  or  equal 
to  300  ft). 


LIST  C41  WHERE  C49  NE  300.0;  (select  piezometer  names  for  a11 

tip  elevations  not  equal  to 
300  ft). 

LIST  C41  WHERE  C49  SPANS  200.0*300.0;  (select  piezometer  names 

for  all  tip  elevations 
equal  to  200  through 
300  ft), 

LIST  C41  WHERE  C49  EQ  200.0*300.0;  (same  as  above). 

LIST  C41  WHERE  C49  NE  200.0*300.0;  (select  piezometer  names  for 

all  tip  elevations  not 
equal  to  200  through  300  ft). 

The  WHERE  clause  can  be  combined  using  AND  and  OR  connectors  and 
using  parentheses  to  group  conditions  for  clarity.  AND  connec¬ 
tors  are  used  when  multiple  conditions  must  be  true*  while  OR 
connectors  are  used  when  only  one  of  several  conditions  must  be 
true.  This  gives  the  user  the  capability  of  asking  some  complex 
questions  as  the  following  example  Indicates; 

LIST  C41,C91,C93  WHERE  Cl  EO  MICHAEL  KIRWAN  AND  (C41  EO  70-C-l 
OR  C41  EQ  70-C-2)  AND  C93  SPANS  970.0*972.0; 

When  using  WHERE  clauses,  the  user  must  ensure  the  variables  In 
the  clauses  are  KEY  variables  and  that  they  are  In  the  same 
repeating  group  as  at  least  one  variable  In  the  object  list.  If 
multiple  lines  are  used  to  Irput  a  command,  always  type  a  space 
at  the  beginning  of  each  additional  line. 

DITTO  command. 

After  successfully  typing  a  long  quei^  and  obtaining  the  desired 
results,  the  user  would  like  the  same  Information  for  a  different  WHERE  clause 
condition.  The  DITTO  command  causes  the  previous  command  on  the  left  of  the 
WHERE  clause  to  be  reused.  To  obtain  the  same  Information  as  shown  above  for 
piezometers  70-C-3  the  following  would  be  entered: 

DITTO  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EQ  70-C-3  AND  C93  SPANS 
970.0*972.0; 

SAME  COTimand. 

TRe  SAME  command  does  the  same  as  the  DITTO  command  except  that  It 
works  on  the  right  side  of  the  WHERE  clause.  The  following  example  illustrates 
this  command: 

LIST  C41  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C59  EQ  OPEN  STANDPIPE; 
LIST  PFD,PSTA,TIPEL  WHERE  SAME; 

Both  the  DITTO  and  SAME  commands  can  be  combined  in  the  same 
LIST  or  PRINT  command.  When  this  occurs,  the  report  is 
duplicated.  This  may  be  useful  If  some  printout  was  lost  due  to 
transmission  error  or  some  other  problem.  Also  the  SAME  command 
has  an  additive  capability;  thus  the  user  can  narrow  data  of 
interest  as  shown  In  the  following  example: 

75 


LIST  PNO.TIPEL.PSTA  WHERE  PROJ-NAME  EQ  MICHAEL  KIRWAN  AND 
TYPIEZ  EQ  OPEN  STANDPIPE; 

DITTO  WHERE  SAME  AND  TIPEL  EQ  310.*320.; 

The  first  example  defines  the  data  group  to  a  project  and  a  type 
of  piezometer.  The  second  query  further  narrows  the  data  group 
to  those  with  tip  elevations  310  through  320,  If  the  OR  con¬ 
nectors  are  used  instead  of  the  AND  connectors,  the  data  group 
can  be  enlarged. 

ORDERING  statements. 

47.  The  ORDERED  BY  clause  allows  the  user  to  sequence  the  output  in 
ascending  (low)  or  descending  (high)  order  according  to  data  elements  asso¬ 
ciated  with  the  record.  Ascending  order  is  assumed.  For  example: 

LIST  C41,C91,C93,0RDERED  BY  LOW  C91  WHERE  C41  EQ  70-C-1; 

Will  list  the  dates  and  readings  for  piezometer  70-C-l  in  as¬ 
cending  order  of  the  dates.  If  descending  order  is  desired,  it 
is  recommended  that  the  HIGH  and  LOW  modifiers  be  attached  in 
front  of  each  data  element  as  shown  below: 

LIST  C41,C91,C93, ORDERED  BY  LOW  C91,HIGH  C93  WHERE.  .  , 

The  ORDERED  BY  clause  can  also  be  used  in  the  PRINT  command. 

There  must  be  a  comma  between  the  list  of  data  elements  and  the 
ORDERED  BY  clause. 

System  function. 

In  addition  to  listing  (or  printing)  the  data  elements  themselves. 
System  2000  can  generate  the  following  statistical  information: 

COUNT(PNO)  -  count  how  many  piezometer  names  exist 

MIN(TIPEL)  -  determine  the  minimum  tip  elevation 

MAX(TIPEL)  -  determine  the  maximum  tip  elevation 

AVG(PREAD)  -  determine  the  average  of  the  piezometer  readings 

SUM(PREAD)  -  generate  the  summation  of  the  piezometer  readings 

SIGMA(PREAD)  -  generate  the  standard  deviation  of  the  piezometer 
readi ngs 

These  functions  can  only  be  used  in  the  LIST  or  PRINT  commands 
as  the  following  example  illustrates,  not  in  a  WHERE  clause. 

LIST  COUNT(PNO),MIN(TIPEL),MAX(TIPEL),AVG(TIPEL),SUM(TIPEL), 
SIGMA(TIPEL)  WHERE  PROJ-NAME  EO  MICHAEL  KIRWAN; 

Format  option. 

4^,  the  user  may  control  the  format  of  the  PRINT  retrievals  by  specifying 
a  format  option  other  than  the  default  option  of  tree,  stubs,  and  component 
numbers.  The  various  options  are: 


a. )  STUB  -  prints  element  name  or  component  number 

before  value. 

STUB  SUPPRESS  -  deletes  element  name  or  component  number 
before  value. 

b. )  NUMBER  -  uses  component  number  as  stub 

NAME  -  uses  element  name  as  stub 

c. )  TREE  -  prints  a  repeating  group  and  all  lower  data 

associated  with  the  repeating  group. 

GROUP  -  prints  only  the  requested  repeating  group. 

The  following  examples  illustrate  the  use  and  results  of  format 
options. 

?  PRINT/GR0UP/C40  WH  C41  EQ  70-C-l; 

41*  70-C-l 
43*  EMB. 

45*  66+00 

47*  15U/S 

49*  936.0 

51*  1015.0 

59*  OPEN  STANDPIPE 

61*  OPER. 

63*  01/21/1983 

88*  0.0 

?  PRINT/NAME/C40  WH  C41  EQ  70-C-l; 

PNO*  70-C-l 
PFD*  EMB. 

PST A*  15U/S 
TIPEL*  936.0 
TREL*  1015.0 
TYPIEZ*  OPEN  STANDPIPE 
PSAT*  OPER. 

PDI*  01/21/1983 
PTH4/*  0.0 


?  PRINT/SfUB  SUPPRESS/C40  WH  C41  EQ  70-C-l; 
70-C-l 
EMB. 

66+00 

15U/S 

936.0 

1015.0 

OPEN  STANDPIPE 
OPER. 

01/21/1983 

0.0 


tally  command. 

The  TALLY  command  provides  a  summary  of  unique  values  and  occur¬ 
rences  of  KEY  data  elements.  WHERE  clauses  are  not  allowed.  There  are  two 
types  of  TALLY  commands,  ALL  and  EACH.  The  following  information  can  be 
obtained  for  each  of  these  types: 

a. )  MAXIMUM  AND  MINIMUM  VALUES  OF  REQUESTED  ELEMENT 

(/all/) 

b. )  NUMBER  OF  OCCURRENCES  OF  THE  ELEMENTS  REQUESTED 

ELEMENT  (/ALL/) 

C.)  NUMBER  OF  UNIQUE  VALUES  OF  THE  ELEMENTS  REQUESTED 

ELEMENT  (/ALL/) 

d. )  THE  UNIQUE  VALUES  FOR  REQUESTED  ELEMENT  (/EACH/) 

e. )  THE  NUMBER  OF  OCCURRENCES  OF  EACH  UNIQUE  VALUE 

FOR  REQUEST®  ELEMENT  (/EACH/) 

The  following  examples  illustrate  the  two  types  of  TALLY 

commands. 

TALLY/ALL/PNO;  -  Prints  the  element  name,  minimum  value, 

maximum  value,  number  of  unique  values  and 
total  number  of  occurrences. 

TALLY/EACH/TYPIEZ;  -  Prints  the  element  name  and  a  table  of 

frequency  versus  unique  value,  then  the 
number  of  unique  values  and  total  number  of 
occurrences,  (useful  for  checking  mis¬ 
spelled  names) 

WHERE-clauses  are  not  allowed  in  a  TALLY  command. 

DESCRIBE  command. 

The  DESCRIBE  command  will  print  the  System  2000  directory  of  data 
elements.  Component  numbers  and  element  names  are  listed  along  with  some  other 
attributes  that  are  listed  in  Table  1.  The  command  to  list  the  entire  data 
base  is  illustrated  below: 


DESCRIBE; 


To  list  only  part  of  the  data  base,  the  following  command  would 
be  used: 

DESCRIBE  40  THRU  90; 

Abbreviations. 

System  2000  allows  users  to  use  a  number  of  abbreviations  and 
shorthand  notations  to  simplify  their  queries.  The  valid  abbreviations  are: 

TA  =  TALLY 

LI  =  list 

PP  =  PRINT 

WH  =  where 

OB  =  ORDERED  BY 

01  =  DITTO 

SA  =  SAME 

CH  =  CHANGE 

Fomatted  LIST  command. 

The  LIST  command  can  allow  you  to  list 
information  in  many  different  ways  by  using  the  TITLE  options. 

These  options  would  generally  be  used  for  reports  that  require 
sorted  lists  of  various  information  from  the  data  base.  Three 
options  can  be  defined  in  the  TITLE  clause.  These  options  are: 

(1)  D(NN)TEXT  -  ADD  A  REPORT  HEADING  AT  THE  TOP  OF  THE  REPORT. 

THE  CURRENT  DATE  WILL  BE  CENTERED  UNDER  THE 
'TEXT'  HEADING.  NOTE:  DO  NOT  USE  ANY  COMMAS 
(',')  IN  YOUR  HEADING. 

(2)  F(MM)TEXT  -  ADD  A  REPORT  FOOTING  AT  THE  BOTTOM  OF  EACH  PAGE 

AND  SPECIFY  A  PAGE  SIZE. 

(3)  COLUMN-HEADERS  -  MODIFY  THE  HEADERS  ON  EACH  COLUMN  OF  OUTPUT 

TO  PRINT  MULTI-LINE,  USER-SPECIFIED  COLUMN 
HEADERS  INSTEAD  OF  DATA  ELEMENT  NAMES.  THE 
USER  WILL  NEED  TO  REFER  TO  THE  FULL  SYSTEM 
2000  DOCUMENTATION  FOR  DETAILS  ABOUT  THIS 
OPTION. 

The  following  examples  illustrate  the  page  heading  and  footnote 
options : 

LIST/TITLE  D(NN)TEST/  ...; 

LIST/TITLE  F(MM)TEXT/  ...; 

D(NN)  indicates  you  want  a  descriptive  heading  at  the  top  of  the 
page.  The  current  data  will  be  printed  centered  under  your  text 
heading.  If  the  TEXl  is  blank,  only  the  date  will  be  printed. 


The  value  NN  is  the  starting  position  (in  characters  from  the 
left)  of  the  beginning  character  of  TEXT,  F(MM)  without  TEXT 
defines  a  page  size  of  MM  (try  55),  The  TEXT  will  be  printed 
following  one  blank  line  at  the  bottom  of  each  page  and  will 
start  in  the  leftmost  print  column,  A  bug  in  System  2000  causes 
the  first  character  of  the  footing  not  to  print.  Use  a  decimal 
(,)  as  the  first  character  and  there  will  be  no  problems.  Head¬ 
ings,  footings,  and  column -headers  can  be  combined  in  one  LIST 
command. 

Example  4 

54,  The  following  data  base  session,  shown  in  Table  13,  illustrates  some 
of  the  data  sets  selected  by  the  natural  retrievals  discussed  in  the  previous 
section.  To  limit  the  amount  of  output  generated,  some  of  the  WHERE  clauses 
are  more  restrictive  in  the  examples  than  in  the  previous  descriptions.  Part 
of  this  section  accessed  the  Pittsburg  District  data  base.  The  total  cost  for 
the  session  was  about  $5,30, 


Table  13 


Data  Base  Natural  Language  Retrievals 


? 'JSERfXXyjPBN  IS  PIEZDB* 
-556-  ASSIGNED  PIEZDB 


7 


TALLY/ALL/C41? 

ttittttp**************** 


ELEMENT- 

PNO 

MINIMUM- 

A*T. 

MAXIMUM- 

9-AC 

50 

UNIQUE  VALUES 

50 

OCCURRENCES 

?  LI  C41  WH  C45  SPANS  4S+50l!47+00 f 
PNO 

««« 

♦  70-C-4 

♦  70-C-6 

♦  70-C-5 
«  70-C-l 
«  29-AC 
t  29-BC 

♦  11-AC 

♦  70-C-2 

♦  70-C-3 


?  LI  C41-C45-C47  WH  SAME? 


PNO 

PSTA 

POFF 

70-C-4 

46+00 

220D/S 

70-C-6 

46+00 

320D/S 

70-C-5 

46+00 

220D/S 

70-C-l 

46+00 

15U/S 

29-AC 

46+14 

600D/S 

29-BC 

46+14 

600D/S 

11-AC 

46  +  40 

275D/S 

70-C-2 

46+00 

120D/S 

70-C-3 

46+00 

120D/S 
(Contlniiod  ) 
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Table  13  (Continued) 


?  L!  C41 f C?1 fC93f OB  LOW  C?1  WH  C41  EQ  70-C-4  AND  C?1  SPANS 


?  0?/01/19B2l!l2/30/l?82  f 


PNO 

*«* 

PDTRD 

PREAD 

* 

70-C-4 

09/23/1982 

932.0 

* 

70-C-4 

10/27/1982 

931.7 

» 

70-C-4 

11/24/1982 

932. 1 

« 

70-C-4 

12/23/1982 

931.9 

?  DITTO  WH  C41  EQ  POOL  AND  C91  SPANS  09/01/1982*12/30/1982« 


PNO 

t** 

PDTRD 

PREAD 

« 

POOL 

09/23/1982 

976.3 

POOL 

10/27/1982 

975.8 

* 

POOL 

11/24/1982 

976.6 

« 

POOL 

12/23/1982 

979.5 

?  LI  C41 '091  •C93fOB  LOW  C41  WH  C45  SPANS  45+501t4?+00 


?  AND  CQi  SPANS  04/01/19831t06/30/1983- 


PNO 

*** 

PDTRD 

PREAD 

11-AC 

04/26/1983 

946.4 

♦ 

11-AC 

06/29/1983 

945.2 

« 

ll-AC 

05/25/1983 

945.7 

♦ 

29-AC 

05/25/1983 

941.2 

♦ 

29-AC 

06/29/1983 

941.2 

« 

29-AC 

04/26/1983 

941.2 

* 

29-BC 

06/29/1983 

959.5 

« 

29-BC 

05/25/1983 

970.2 

29-BC 

04/26/1983 

1000.5 

« 

70-C-2 

06/29/1983 

932.0 

« 

70-C-2 

04/26/1983 

932.4 

* 

70-C-2 

05/25/1983 

932.5 

* 

70-C-3 

05/25/1983 

942.4 

« 

70-C-3 

06/29/1983 

941.0 

« 

70-C-3 

04/26/1983 

942.9 

« 

70-C-4 

06/29/1983 

932.0 

70-C-4 

05/25/1983 

932.1 

« 

70-C-4 

04/26/1983 

932.3 

« 

70-C-5 

06/29/1983 

944,1 

« 

70-C-5 

04/26/1983 

944.7 

70-C-5 

05/25/1983 

944.8 

* 

70-C-6 

04/26/1983 

932.5 

70-C-6 

05/25/1983 

932,7 

« 

70-C-6 

06/29/1983 

932.6 

(Conti 

nucd) 

(Siioot  2  Ox'  7) 


'able  13  (Continued) 


PR/GR0UP/C40  WH  C41  EQ  29-BC* 

41*  29-BC 
45*  46+14 
47*  600D/S 
49*  838.7 

51*  944.4 

59*  GAUGE  ON  STANDPIPE 
61*  OPER. 

88*  0.0 


(Continued) 
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Table  13  (Continued) 


?  TALLY/EACH/Cl? 
t  *  *  Id  i|[  !K 

ELEMENT-  PROJ-NAME 

FREQUENCY  VALUE 


1 

ALLE6.L/D  2 

1 

ALLEG.L/D  3 

1 

ALLEG.L/D  4 

1 

BERLIN  LAKE 

1 

CONEMAUGH  LAKE 

1 

CROOKED  CREEK  LAKE 

1 

DASHIELDS  L/D 

1 

EAST  BRANCH  LAKE 

1 

EMSWORTH  L/D 

1 

HANNIBAL  L/D 

1 

HILDEBRAND  L/D 

1 

KINZUA  DAM 

1 

LOYALHANNA  LAKE 

1 

MAHONING  LAKE 

1 

MAXWELL  L/D 

1 

MICHAEL  J.  KIRWAN  DAM 

1 

MONTGOMERY  L/D 

1 

MON.L/D  2 

1 

MON, L/D  3 

1 

MON, L/D  4 

1 

MON, L/D  7 

1 

MORGANTOWN  L/D 

1 

MOSQUITO  CREEK  LAKE 

1 

NEW  CUMBERLAND  L/D 

1 

OPEKISKA  L/D 

1 

PIKE  ISLAND  L/D 

1 

SHENANGO  LAKE 

1 

TIONESTA  LAKE 

1 

TYGART  LAKE 

1 

UNION  CITY  RES, 

1 

WOODCOCK  LAKE 

1 

YOUGHIOGHENY  LAKE 

32 

UNIQUE  VALUES 

32 

OCCURRENCES 

( Continued ) 
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Table  13  (Continued) 


?  LIST  COUNT  C41  WH  Cl  EQ  TIONESTA  LAKE- 
CNT  PNO 

*«* 

*  24 

?  LI  C41  UH  Cl  EQ  TIONESTA  LAKE? 

PNO 

*  78-T-l 

*  78-T-2 

*  78-T-3 

*  78-T-4 
»  POOL 

«  T.U« 

*  78-T-5 

*  78-T-6 
»  78-T-7 

*  78-T-8 

*  78-T-12 

*  78-T-13 

*  78-T-14 

*  78-T-15 
»  78-T-16 

*  78-T-ll 
»  78-T-lO 

*  78-T-9 

*  78-T-17 

*  PRECIP. 

«  UEATH. 

*  A.T. 

«  WEIR  1 
«  WEIR  2 


?  LI  MAX  C91-MIN  C91  WH  Cl  EQ  TIONESTA  LAKE  AND  C41  EQ  78-T-l 
MAX  PDTRD  MIN  PDTRD 

»  12/31/1983  08/10/1919 


(Continued) 


Table  13  (Continued) 


7  LI  C41fC?lfC93  UH  C91  EQ  08/10/1919? 
PNO  PDTRD  PREAD 

««» 

*  78-T-l  08/10/1919  1069.5 


?  LI  C41fC91.C93  UH  C93  EQ  1069.5? 


PNO 

*78-1-1 
♦  78-T-l 


PDTRD  PREAD 

01/10/1979  1069.5 

08/10/1919  1069.5 


?CH  C93  EQ  6666, 6*UH  Cl  EQ  TIONESTA  LAKE  AND  C41  EQ  78-T-l 

?  AND  C91  EQ  08/10/1919? 

1  SELECTED  DATA  SETS  - 

?  LI  C91.>C93  UH  C91  EQ  08/10/1919? 

PDTRD  PREAD 

*** 

»  08/10/1919  6666.6 

?  CH  C91  EQ  08/10/1983»WH  C93  EQ  6666,6? 

1  SELECTED  DATA  SETS  - 

?  CH  C93  EQ  1069. 5*WH  Cl  EQ  TIONESTA  LAKE  AND  C41  EQ 

?  7S-T-1  AND  C91  EQ  08/10/1983? 

1  SELECTED  DATA  SETS  - 


9 


(Continued) 
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Table  13  (Concluded) 


?  LI  C41fC91*C?3  WH  Cl  EQ  TIONESTA  LAKE  AND  C?1  FAILS- 


PNO 

*  78-T-l 


PDTRD 


PREAD 


1070.0 


TADD  C91  EQ  04/28/1983*WH  Cl  EQ  TIONESTA  LAKE  AND  C41  EQ  78-T-i 


?  AND  C93  EQ  1070,05 

^  SELECTED  DATA  SETS  - 


LI  C41.C91.C93  WH  Cl  EQ  TIONESTA  LAKE  AND  C41  EQ  78-T-l 

?  AND  C93  EQ  1070,05 

PNO  PDTRD  PREAD 

*** 

»  78-T-l  04/28/1983  1070.0 


EXIT5 

18  21588  84/06/08.  14.43.22 
Sy06/08.  14.47,48.  END  SYSTEM  2000  VERSION  2.60F 
STOP  S2K 


Interactive  Data  Modifications 


55,  Data  in  the  piezometer  data  base  can  be  modified  either  with  the 
data  entry  program  described  in  Part  III  or  with  the  System  2000  natural 
language  commands  described  in  this  section.  The  data  entry  program  is  capa¬ 
ble  of  editing  the  project  and  piezometer  data  levels.  The  reading  repeating 
group  data  can  only  be  modified  by  the  natural  language  commands.  There  are  a 
number  of  commands  that  can  either  add  or  modify  data  when  the  user  is  working 
on  line  with  the  data  base.  Of  these,  there  are  three  commands  that  the  user 
of  this  data  systen  should  be  aware  of;  they  are  ADD,  CHANGE,  and  REMOVE. 

Each  of  these  commands  will  be  described  in  detail  below.  These  three  com¬ 
mands  deal  with  adding  to  or  modifying  existing  data  groups;  if  the  user  wants 
to  insert  new  data  groups,  he  should  either  use  the  data  entry  program  de¬ 
scribed  in  Part  III  or  refer  to  the  System  2000  documentation.  The  data  base 
can  be  damaged  in  this  interactive  mode,  and  a  backup  copy  is  reconmended  (see 
Appendix  A),  Before  using  these  commands,  the  user  must  understand  the  WHERE 
clause  information  discussed  in  paragraph  43  because  each  of  these  commands 
will  modify  or  add  data  as  specified;  thus,  each  command  must  uniquely  identify 
the  data  set  (project  name,  oiezometer  name,  or  reading  date)  so  that  only  the 
intended  data  is  changed.  After  each  command  is  executed,  the  computer  will 
respond  with  the  number  of  selected  data  sets  that  were  modified.  It  is 
strongly  recommended  that  before  a  data  modification,  the  CHANGE  or  REMOVE 
command  is  replaced  with  a  LIST  command  which  is  then  executed  to  ensure  that 
only  one  selected  data  set  will  be  modified.  If  more  data  sets  are  involved 
than  the  user  expected,  he  needs  to  determine  what  else  needs  to  be  specified 
in  the  WHERE  clause  so  that  the  data  set  to  be  modified  is  uniquely  identified, 

ADD  command. 

56,  TFe  ADD  command  is  used  to  add  one  or  several  elements  of  data  to 
an  existing  data  group  where  no  data  presently  exist.  This  command  is  used 
when  a  few  elements  of  data  need  to  be  added  to  a  data  group.  The  following 
example  illustrates  format  to  add  one  component,  in  this  case,  the  date  of 
installation  to  the  piezometer's  data: 

ADD  C63  EQ  01/21/1983*WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EQ 

70-C-l; 


1  SELECTED  DATA  SETS  - 


The  computer  response  indicates  how  many  data  sets  were  modi¬ 
fied.  To  add  more  than  one  element  the  following  example  illus¬ 
trates  the  procedure  for  two  elements: 

ADD  C40  EQ  55*1.5*57*CLAY*END*WHERE  C41  EQ  70-C-l; 

1  SELECTED  DATA  SETS  - 


The  data  element  names  and  component  numbers  are  defined  in 
Table  1.  All  data  base  commands  must  end  with  a  semicolon  (;), 
and  the  asterisk  (*)  is  the  system  separator.  The  equal  opera¬ 
tion  (EQ)  is  the  only  valid  operator  for  the  ADD  command.  If  a 
value  exists  for  an  element  and  another  value  is  attempted  to  be 
added,  the  system  would  tell  the  user  zero  data  sets  were 
selected.  When  multiple  elements  are  added,  the  word  "END*" 
must  appear  after  the  last  value  to  be  added;  otherwise,  the 
command  will  not  be  accepted.  Multiple  elements  that  are  not  in 
the  same  repeating  group  cannot  be  added  in  the  same  command. 

CHANGE  command. 

57.  The  CHANGE  command  is  used  to  modify  one  or  several  existing  data 
element  values.  This  command  is  used  to  correct  errors  that  are  found  in  the 
data  base.  Two  examples  of  the  CHANGE  command  are: 


?  CHANGE  C93  EQ  933.4*WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EO 


?  70-C-2  AND  C91  EQ  Q4/26/1983; 

CHANGE  C90  EQ  91*04/27/1983*93*1 in.4*END*WHERE  Cl  EQ  MICHAEL 
KIRWAN  AND  C41  EO  70-C-2  AND  C97  EQ  I  NOPE R.; 

All  the  nomenclature  is  either  defined  in  Table  1  or  for  the  ADD 
command.  The  value  after  the  EQ  is  always  the  corrected 
value.  The  first  example  will  change  just  the  reading  value, 
while  the  second  example  will  change  both  the  date  and  reading 
value.  All  the  details  of  the  CHANGE  command  are  the  same  as 
the  ADD  command.  As  mentioned  previously,  it  is  strongly  recom¬ 
mended  that  before  any  CHANGE  command  is  executed,  the  CHANGE 
command  should  be  replaced  with  a  LIST  command  so  that  the  user 
can  ensure  that  only  one  data  set  will  be  modified.  The  follow¬ 
ing  sequence  of  commands  should  be  used: 

?  LIST  C91,C93  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND 
C41  EQ  70-C-l  AND  C93  EQ  932.4; 


OO 


computer  response: 


04/26/1983  932.4 


* 


The  user  knows  that  the  values  to  be  changed  are  uniouely 
identified.  If  more  than  one  value  was  listed,  the  user  would 
have  to  modify  the  WHERE  clause  until  only  the  value  of  interest 
was  listed.  The  next  command  is  the  CHANGE  command  as  described 
earlier.  The  following  procedure  can  be  used  if  the  elevation 
or  date  is  not  able  to  uniquely  identify  a  reading. 

?  LIST  C91,C93  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EO  70-C-l  and 
C93  EO  932.4; 


PDTRD 

PREAD 

*** 

*  01/23/1983 

932.4 

*  04/26/1983 

932.4 

Since  932.4  is  not  a  unique  number,  it  must  be  changed  so  that  it 
can  be  used  to  qualify  the  reading  date  (04/26/1983). 

The  next  command  is: 

?  LIST  C91,C93  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EO  /O-C-l  AND 
C91  EQ  04/26/1983 
PDTRD  PREAD 

*** 

*  04/26/1983  932.4 

The  date  can  be  used  to  uniquely  define  the  reading  value.  Thus, 
by  changing  the  reading  value  the  reading  can  be  uniquely  iden¬ 
tified  so  that  the  date  can  be  changed.  The  command  sequence 
for  this  procedure  is  as  follows: 

CHANGE  C93  EO  999.9*WHERE  C41  EO  70-C-l  AND  Cl  EQ  MICHAEL  KIRWAN 
AND  C91  EQ 

?  04/26/1983; 

-  1  SELECTED  DATA  SETS  - 

The  reading  value  999.9  is  now  unioue,  and  the  reading  date  can 
be  changed. 


CHANGE  C91  EO  04/16 /1983*WHERE  Cl  EO  MICHAEL  KIRWAN  ANO  C41  EO 


?  70-C-l  AND  C93  EQ  999.9; 
-  1  SELECTED  DATA  SETS  - 


The  reading  date  has  been  corrected,  the  user  must  now  change 
999.9  back  to  its  original  value. 

?  CHANGE  C93  EO  932.4*WHERE  Cl  EO  MICHAEL  KIRWAN  AND  C41  EO 


?  70-C-l  AND  C91  EQ  04/16/1983; 

-  1  SELECTED  DATA  SETS  - 

If  the  CHANGE  command  did  not  have  sufficient  qua"* ifications, 
the  following  would  happen: 


?  CHANGE  C93  EQ  932.4*WHERE  C91  EO  04/16/1983; 
-  50  SELECTED  DATA  SETS  - 


? 

All  reading  values  for  every  project  and  every  piezometer  with 
the  date  04/16/1983  was  changed  to  932.4,  which  include  the  one 
the  user  wanted  to  change  and  forty  nine  others.  If  this  should 
happen,  call  your  system  coordinator. 

REMOVE  command. 

58.  The  purpose  of  the  REMOVE  command  is  to  delete  data  from  the  data 
base.  The  user  is  reminded  of  the  importance  of  uniouely  defining  the  data  to 
be  removed  so  that  other  data  is  not  lost.  An  example  of  the  REMOVE  command  i 

REMOVE  C88  WHERE  Cl  EQ  MICHAEL  KIRWAN  AND  C41  EQ  70-C-l; 

The  nomenclature  has  been  previously  defined.  This  example 
removes  the  fourth  threshold  value  for  piezometer  70-C-l  from 
the  data  base.  Multiple  data  elements  cannot  be  removed  by 
using  one  command;  however,  the  following  illustrates  how  a 
complete  reading  is  removed, 

REMOVE  TREE  PRED  WHERE  Cl  EO  MICHAEL  KIRWAN  AND  C41  EQ  70-C-l 
AND  C91  EQ  04/26/1984; 

Here  again  the  use  of  the  LIST  command  before  the  REMOVE  command 
is  strongly  recommended. 


string  Retrievals 

Description 

59.  A  frequent  or  long  command  can  be  stored  as  a  component  of  the  data 
base  and  executed  by  specifying  only  the  component  number.  These  user-defined 
components  which  alleviate  the  user  from  having  to  repeatedly  enter  a  long 
command  are  called  strings.  The  format  for  specifying  these  components  is: 

COMPONENT  *  STRING  (STRING  ($  Natural  language  S)) 

NUMBER  NAME  command 

The  dollar  signs  are  the  same  as  another  set  of  parentheses.  By  using  the 
above  form,  the  semicolon  ending  the  command  is  embedded  in  the  component 
and  is  not  necessary  when  executing  the  string.  To  find  out  whether  there 
are  any  strings  associated  with  the  user's  data  base,  the  following  natural 
language  command  is  used: 

DESCRIBE  STRINGS; 


There  are  two  types  of  strings.  The  difference  between  the  two  is  the 
information  necessary  to  execute  the  retrievals. 

Simple  string. 

60.  the  simple  string  retrieves  data  according  to  a  natural  language 
command  that  does  not  need  any  user  input.  An  example  for  this  type  of  string  is 

1000*SIMSTRG(STRING(LIST  C1,C41,MAX(C91 ) ; ) ) 

This  string  command  will  list  the  latest  reading  date  for  all 
piezometers  of  all  the  projects  in  the  data  base.  To  execute 
the  string,  one  of  the  following  commands  is  specified: 

*C1000* 

or 

♦SIMSTRG* 

Extended  string. 

61.  The  extended  string  retrieves  data  according  to  a  natural  language 
command  which  requires  user  input  which  is  substituted  for  the  variables  in  the 
string.  An  example  of  this  type  of  string  is: 

2000*EXTSTRG(STRING(LIST  C41 ,C91 ,C93,0B  LOW  C91 
WHERE  Cl  EO  *1*  AMO  C41  EG  *2*  AND  C91  SPANS  *3*;)) 
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This  string  command  will  list  the  piezometer  name,  reading 
dates,  and  readings  in  ascending  order  of  the  date  within  a 
prescribed  period.  The  user  must  specify  the  actual  argument  to 
replace  the  symbolic  arguments.  For  this  example,  the  user  must 
specify  the  project  name  (*1*),  the  piezometer  name  {*?.*)  and 
the  beginning  and  ending  dates  for  the  report  (*3*).  For  this 
case  the  last  argument  actually  consists  of  two  dates  separated 
by  the  system  separator  (*).  To  operate  this  string  one  of  the 
following  commands  is  specified: 

*C2000  (project  name,  piezometer  name,  begin  date  *  end  date) 
or 

♦EXTSTRG  (project  name,  piezometer  name,  begin  date  *  end  date) 

lie  5 

62.  Table  14  (Example  6)  illustrates  how  strings  are  used. 


63.  After  the  user  is  faniliar  with  the  natural  language  retrievals, 
there  are  many  results  or  data  groupings  the  user  would  like  to  generate.  The 
Report  Writer  feature  of  the  data  base  was  designed  to  generate  frequently 
used  output  formats  (Intel  Corp.  1981b).  The  Report  Writer  will  generate  a 
set  fomat  and  allow  the  user  to  select  the  data  groups  of  interest.  The  data 
base  files  are  scanned  once  for  each  report;  whereas,  the  files  are  scanned 
for  each  interactive  command.  The  difference  between  string  and  Report  Writer 
retrievals  is  that  the  Report  Writer  allows  for  more  complexity  in  the  output 
format  and  in  the  manipulation  of  the  data.  The  user  is  referred  to  the 
System  2000  GENIUS  program  (GET,GENIUS/IIN=CECE2K;  GENIUS  and  USE  OPTIONS  88 
and  89)  or  the  User's  guide  (Intel  Corp.  1982)  for  easy  preparation  of  a 
report  writer  file. 

64.  At  the  present  time,  there  is  only  one  Report  Writer  file  developed 
for  the  piezometer  data  base  system.  This  file  called  MAXDATE  will  list  the 
last  reading  date  for  specified  projects.  This  oarticular  file  is  similar  to 
the  string  retrieval  example.  The  data  generated  by  this  file  will  assist  the 
District/Project  personnel  in  keeping  track  of  reading  schedules. 

65.  To  execute  any  Report  Writer  file,  the  following  two  step  procedure 
is  necessary: 

File  ayailabil ity.  All  files  on  Control  Data  System  are  stored 
on  disks;  thus  any  file  the  user  accesses  must  be  put  in  the 
user's  work  space.  To  put  files  in  this  work  space,  the  com¬ 
puter  must  "GET"  the  files  from  the  disk  storage.  The  recom¬ 
mended  method  of  putting  files  in  the  user's  work  space  is  to 
issue  a  GET  command  before  the  data  base  command  file  is  executed. 
An  example  of  the  first  step  in  this  procedure  is; 

GET,MAXDATE/UN=CER0K2 

-GETDB 

This  will  put  the  Report  Writer  file  MAXDATE  in  the  user's  work 
space  along  with  accessing  the  data  base.  Once  the  file  is  in 
the  user's  work  space,  the  data  base  can  access  the  file  using 
the  second  step  described  below. 

_b.  Report  generation.  When  the  user  is  working  interactively  with 
the  data  base,  the  system  is  initially  reading  all  commands  from 
the  terminal  which  is  considered  INPUT.  If  the  user  wants  to 


have  the  data  base  read  conmands  from  a  file,  the  following 
command  is  used: 

COMMAND  FILE  IS  (file  name); 

The  file  name  is  supplied  by  the  user  from  the  list  of  files 
available  in  the  work  space.  If  the  file  contains  a  series  of 
natural  language  retrieval  commands,  the  data  base  will  execute 
the  commands  in  the  order  they  appear  in  the  file.  However,  if 
the  file  is  a  Report  Writer  file,  the  data  base  will  compile  the 
commands  and  execute  the  report  if  a  GENERATE  statement  is 
included  in  the  file.  If  this  statement  is  not  in  the  file,  the 
user  must  enter  it  after  the  report  is  compiled.  A  GENERATE 
statement  will  select  the  data  the  user  is  interested  in 
obtaining.  It  can  contain  a  WHERE  clause  to  select  the  data  as 
illustrated  in  the  following  example: 

GENERATE  (report  name)  WHERE  (valid  where  clause); 

The  report  name  is  the  name  given  to  the  Report  Writer  format. 

Example 

66.  The  following  example  illustrates  the  use  of  a  Report  Writer  file 
that  contains  natural  language  commands: 


6ET,MAX0ATE 
/-GETDB 
"S2K  2.80F" 

?  USER, XXX; SHARED  DBN  IS  PIEZDR; 

?  COMMAND  FILE  IS  MAXDATE; 
PROJECTS  AND  DATE  OF  LAST  READING 
84/05/10. 

PROJ-NAME 


*** 

*  TIONESTA  LAKE 

♦** 

12/31/1 983 

*  BERLIN  LAKE 

*** 

12/27/1983 

♦  CONEMAUGH  LAKE 

12/23/1983 

*  CROOKED  CREEK  LAKE 


03/08/1 984 


*  EAST  BRANCH  LAKE 


01  /23/1984 


*  EMSWORTH  L/D 

01/16/1 984 

*  MONTGOMERY  L/D 

*** 

09/20/1 984 

*  NEVI  CUMBERLAND  L/D 

03/07/1984 

*  PIKE  ISLAND  L/D 

*** 

03/27/1 984 

*  MON, L/D  2 

itifit 

03/23/1 984 

Graphic  Plots 

67.  The  five  graphic  display  program  available  for  use  with  the  piezom¬ 
eter  data  base  package  are: 

PZ,  to  plot  piezometer  time  histories  of  selected  piezometers. 

]).  PZPRO,  to  plot  piezometer  readings  on  cross  sections. 

£.  BORMAP,  to  plot  the  location  of  piezometers. 

BORCON,  to  contour  selected  water  surface  data. 

£.  GENXY,  to  plot  column  data  in  x-y  format. 

Programs  £.  and  are  described  in  detail  by  Strohm  and  Palmerton  (1984). 

The  details  of  these  programs  are  included  for  completeness  of  the  piezometer 
package.  Program^,  was  described  by  Edris,  Hammer,  and  Vanadi t-El lis  (1983) 
and  is  also  included  for  completeness  of  the  package.  Two  steps  are  required  to 
use  all  of  the  plot  programs.  The  first  step  is  to  create  a  data  file  of  the 
desired  data  from  the  data  base  using  natural  language  retrievals.  The  second 
step  is  to  access  the  desired  program.  The  first  two  programs  and  the  last 
one  will  only  plot  on  graphics  terminals,  while  the  other  two  programs  have 
the  option  of  plotting  at  the  graphics  terminal  and/or  directing  plots  to  a 
drum  plotter.  The  programs  require  the  use  of  a  Tektronix  type  graphics 
terminal.  The  programs  use  the  CE  Graphics  Compatibility  System  (GCS)  with 
library  routines  that  are  outside  the  programmer's  control.  Thus,  some  incon¬ 
veniences  are  encountered,  such  as  unexpected  screen  erasures  after  an  initial 
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pronpt  and  after  completion  of  drum  plot  option  prompts.  Instructions  to  over¬ 
come  this  problem  are  given  in  the  detailed  descriptions.  This  section 
describes  the  capabilities  and  use  of  each  program  and  gives  examples  of 
their  use. 

Piezometer  Time  History  Plots 

68.  Capabilities.  The  piezometer  time  history  plot  program,  PZ,  is  an 
interactive  program  that  requires  user  input  before  a  plot  can  be  generated. 
Multiple  plots  can  be  placed  vertically  on  a  page  with  several  piezometer 
readings  on  each  scale.  The  time  scale  is  initially  automatically  set  by  the 
largest  time  period  of  any  instrument  in  the  data  file.  The  user  can  vary 
this  scale,  and  the  vertical  scale  after  the  initial  plot  is  generated. 
Different  line  symbols  are  used  for  multiple  instruments.  The  individual  data 
points  are  indicated  by  an  X.  Also,  special  symbols  are  used  to  represent  dry, 
frozen,  and  zero  pressure  readings.  A  bar  chart  will  be  generated  for  the  pre¬ 
cipitation  only  if  it  is  on  the  bottom  vertical  scale. 

69.  Data  file.  The  data  file  for  use  with  PZ  must  be  generated  with 
the  LIST  command.  Once  the  user  has  specified  a  report  file  name 
(paragraph  39),  the  following  command  is  used: 

LIST  C41,C91,C93,  OB  LOW  C91  WHERE  Cl  EO  (project  name) 

AND  C41  EO  (piezometer  name)  AND  C91  SPANS  (dates  for  plot); 

This  command  is  repeated  for  each  piezometer  that  will  be  included  on  the  plot. 
The  user  must  keen  track  of  the  number  of  piezometers  and  the  sequence  of  the 
data  in  the  report  file. 

70.  Plot  execution.  Access  to  and  execution  of  PZ  are  accomplished 
with  the  following  command; 


/BEGIN, ,PZ 


71.  Program  prompts.  The  program  prompt  and  the  user  response  are 
described  below. 


a.  NUMBER  OF  SCALES  ON  THIS  PAGE?  There  can  be  up  to  three 
vertical  scales  per  page. 


b.  HOW  MANY  CURVES  ON  THE  SCALE?  (THE  NUMBER  OF  PIEZOMETER 
PER  SCALE)  If  there  is  only  one  vertical  scale,  then  five 
piezometers  can  be  plotted.  However,  if  there  is  more  than 
one  vertical  scale,  then  a  maximum  of  three  piezometers  can 
be  plotted  on  each  scale. 

c.  AUTOflATIC  HARD  COPIES?  (Yes  or  no) 

d.  NAME  OF  DATA  FILE? 

e.  TITLE  FOR  PLOTS? 

f.  Y-AXIS  LABEL? 

After  the  initial  plot,  the  program  prompts  the  user  about  replotting  at  a 
different  time  scale  and/or  vertical  scale.  If  another  plot  is  chosen,  the 
user  can  input  the  minimum-maximum  and  interval  for  each  scale.  If  the  user 
chooses  not  to  replot  the  data,  additional  data  files  can  be  plotted  or  the 
program  can  be  terminated. 

72.  Example.  Table  15  shows  an  example  of  data  file  generation  and  use 
of  the  PZ  program. 

Piezometer  cross-section  plots 

73.  Capabilities.  The  piezometer  cross-section  plot  program,  PZPRO, 
will  plot  the  piezometers  for  a  given  station  on  a  user-supplied  cross  section. 
Up  to  three  elevation  readings  can  be  specified  for  the  piezometers  and  the 
Dool  level.  Cross  sections  can  be  entered  during  the  interactive  session  or 
read  in  from  a  data  file.  The  location  of  the  piezometers  on  the  cross  section 
is  determined  by  the  offset  value  since  the  station  is  constant.  A  legend  is 
included  for  identification  of  reading  dates  and  piezometers. 

7A.  Data  files.  The  user  may  elect  to  create  the  cross-section  data 
file  before  using  the  plot  program.  This  file  can  be  created  interactively 
using  the  plot  program;  however,  since  there  is  no  means  of  correcting 
erroneous  input  values,  it  is  recommended  that  the  user  create  the  file 
separately.  To  create  this  file  the  following  sequence  utilizing  the  system 
edi tor  i s  used: 


/NEW, POINTS 
/XEDIT 

??  (Carriage  return  for  input  mode) 

?2  (Total  number  of  profile  or  stata  in  this  cross  section) 
?10  (Number  of  x  A  y  coordinates  in  the  first  profile) 


BEGIN,, P2 

NUMBER  OF  SCALES  ON  THIS  PAGE?(nAX.  IS  3) 
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?5  (Numbers  of  x  &  y  coordinates  in  the  second  profile) 
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The  user  is  referred  to  paragraph  76  for  limitations  on  entering  the  profile 
data,  the  maximum  number  of  points,  and  the  maximum  range  of  x-axis  values. 

75.  The  data  which  is  to  be  plotted  must  be  retrieved  from  the  data 
base  and  stored  in  a  second  file.  Sign  on  the  data  base  as  described 
previously.  The  user  must  know  which  piezometers  and  the  approximate  dates 
to  be  plotted.  Natural  language  retrievals  are  used  to  obtain  or  verify  the 
data.  An  example  of  an  interactive  retrieval  is  the  following  command; 

LIST  C41,C45,C47,C91,C93  WH  Cl  EQ  (project  name) 

AND  (C45  SPANS  (station  for  plot)  OR  C41  EQ  POOL)  AND 
C91  SPANS  (dates  for  plot); 

This  command  would  list  all  the  data  necessary  for  one  cross-section  plot. 
Instead  of  one  command,  it  could  be  broken  into  two  or  more  commands.  Once 
the  user  knows  what  will  be  plotted,  the  following  commands  are  used  to  estab 
lish  a  report  file. 

?  REPORT  FILE  IS  ZZZ; 

LIST  Cl  WH  Cl  EO  project  name; 

?  LIST  C41,  C45,  C47,  C91 ,  C93  WH  Cl  EO  project  name  AND 
C41  EO  piezometer  number  AND  C91  SPANS  dates  for  plot; 

?  EXIT; 

(Closes  PIEZDB) 

When  the  user  exits  the  data  base,  all  report  files  must  be  saved 
/SAVE,  ZZZ 

76.  Plot  execution.  Access  to  and  execution  of  PZPRO  are  accomplished 
with  the  following  command 


/BEG  IN,, PZPRO 


77,  Program  prompts.  The  program  prompts  and  the  user  responses  are 
described  below. 

NAME  OF  DATA  FILE.  The  user  should  enter  the  name  of  the 
report  file  which  was  created  from  the  data  base  and  saved 
as  a  permanent  file. 

b.  ARE  PROFILE  POINTS  IN  A  FILE?  (Y  or  N)  If  specific  points 
of  the  cross  section  have  previously  been  saved  in  a  file, 
enter  a  Y.  The  following  prompt  will  appear: 

FILE  NAME? 

The  user  should  enter  in  the  file  name  which  contains  the 
set  of  profile  points.  If  the  data  file  does  not  exist,  an 
appropriate  message  will  appear  and  the  user  will  be  prompted 
for  the  correct  file  name.  The  program  will  read  points 
from  the  file  and  proceed  to  the  date  in  prompt  £.  If 
the  profile  points  must  be  entered  during  this  session, 
enter  a  N.  The  user  will  be  asked  for  the  data  in  prompts  £, 
through 

c.  HOW  MANY  PROFILES  ARE  IN  THIS  CROSS  SECTION?  Enter  the 

~  number  of  profiles  or  strata  changes  with  the  cross  section, 

d.  HOW  MANY  PROFILE  POINTS  ARE  THERE?  Enter  the  number  of 
profile  points.  One  profile  point  consists  of  an  X  and  Y 
value,  A  total  of  100  profile  points  is  allowed  for  all  the 
strata  of  one  cross  section. 

e.  WHAT  ARE  PROFILE  POINTS?  (L  to  R;  X,  Y  format)  The  user 
should  enter  profile  points  from  the  far  left  X  value  to  the 
far  right  X  value.  The  format  should  be  X  comma  Y  with  no 
point  having  over  six  digits  including  one  decimal  place. 

The  first  points  must  be  less  than  the  second,  and  the  range 
of  the  offset,  or  X  axis,  cannot  exceed  2,000  ft. 

f.  DO  YOU  WANT  TO  SAVE  PROFILE  POINTS  IN  A  FILE?  (Y  or  N)  If 
the  user  would  like  to  save  the  points  for  later  use,  enter 
a  Y.  The  user  will  then  be  prompted  for  the  file  name. 

ENTER  FILE  NAME  TO  SAVE  PROFILE  DATA. 

Enter  any  seven  characters  for  the  file  to  store  the  profile 
points.  If  a  file  already  exists  with  the  same  name,  an 
appropriate  message  will  appear,  and  the  user  will  be 
reprompted.  With  a  reply  of  N,  the  program  continues  and 
checks  the  offset  range.  If  the  range  is  greater  than 
2,000  ft,  the  program  will  issue  an  appropriate  warning. 

OFFSET  RANGE  TOO  LARGE 

and  then  revert  back  to  prompt  asking  for  a  new  set  of 
profile  points.  When  a  piezometer  data  file  and  profile 
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data  have  been  entered  correctly,  a  list  of  piezometer  num¬ 
bers  with  corresponding  dates  from  the  data  file  will  be 
listed  on  the  screen.  The  next  prompts  allow  the  user  to 
select  the  reading  dates  to  be  plotted. 

£.  HOW  MANY  DATES  DO  YOU  WANT  TO  PLOT?  (Max  is  3)  The  user 
should  enter  1,  2,  or  3  depending  on  the  desired  number  of 
dates  to  be  plotted.  The  maximum  is  three  reading  dates. 

k  WHAT  DATES  WOULD  YOU  LIKE  PLOTTED?  (MM/DD/YYYY)  (PUT  IN 
THE  #  OF  DATES  YOU  HAVE  ALREADY  SPECIFIED)  Choose  the  dates 
from  the  list  on  the  screen.  Enter  only  the  number  of  dates 
specified  in  the  previous  prompt.  The  date  format  is 
MM/DD/YYYY.  When  plotting  is  finished,  a  bell  will  sound 
twice.  The  user  should  make  a  hard  copy  at  this  time.  The 
screen  will  be  erased  upon  entering  a  carriage  return. 

±.  WOULD  YOU  LIKE  TO  PLOT  MORE  DATES  FROM  THIS  FILE?  (Y  or  N) 

The  user  can  plot  more  dates  from  the  same  data  file.  A 
reply  of  Y  will  return  to  the  prompt  f.  Entering  N  causes 
the  program  to  continue. 

j_.  DO  YOU  WANT  TO  PLOT  FROM  A  DIFFERENT  DATA  FILE?  (Y  or  N) 

The  answer  to  this  prompt  allows  the  user  to  generate  plots 
of  different  cross  sections  or  to  tenninate  the  program, 

78.  Example.  Table  16  shows  an  example  of  profile  and  data  file 
generation  and  use  of  the  PZPRO  program. 

Boring  Location  Plots 

79.  Capabilities.  The  boring  location  plot  program,  BORMAP,  asks  for  the 
data  file  name  and  allows  the  user  to  review  the  data  file  and  select  the  data 
group  desired  for  plotting.  The  user  is  then  queried  for  plotting  options. 

The  options  include  data  columns  to  plot,  type  of  coordinates,  plot  title, 
scales,  grid  display,  and  symbol  numbers  with  corresponding  piezometer  numbers. 
Station  and  offset  coordinates  can  be  automatically  converted  to  latitude  and 
longitude  by  entering  the  values  for  the  first  listed  piezometer.  A  polyconic 
projection  can  also  be  obtained.  Station  and  offset  coordinates  can  also  be 
used.  The  values  are  automatically  converted  to  decimal  numbers  with  offsets 
converted  to  plus  and  minus  numbers.  Piezometer  location  plots  can  be  dis¬ 
played  at  the  graphics  terminal  and  also  directed  to  a  drum  plotter  to  produce 
a  plot  to  a  desired  scale  for  use  as  an  overlay  on  an  existing  map.  The  program 
is  available  on  CDC  and  the  WES  Honeywell  computer  system. 

80.  Data  files.  This  data  file  for  use  with  BORMAP  must  be  generated 
with  the  LIST  command.  The  file  should  contain  at  least  the  piezometer  numbers 
and  the  station  and  offset  coordinates.  The  WHERE  clause  in  the  LIST  command 
should  specify  the  desired  project  and  piezometers.  The  data  components  in  the 
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LIST  command  can  be  in  any  order,  since  the  program  displays  the  headings  for 
the  user  to  select.  If  it  is  desired  to  have  piezometer  numbers  listed  in 
numerical  order  with  the  symbol  numbers  at  the  side  of  the  plot,  the  ORDERED  BY 
clause  should  be  used  for  C41  when  creating  the  data  file.  Data  files  that 
already  exist  with  the  desired  data  in  the  desired  order  can  also  be  used. 

81.  Plot  execution.  Access  to  and  execution  of  BORMAP  are  accomplished 
with  the  following  command: 

/BEG IN,, BORMAP 

At  the  beginning  of  the  program,  two  choices  are  given  for  selection  of  80-  or 
132-character  width  screen  by  a  GCS  routine  (choices  0  and  K).  Always  choose  0, 
since  K  causes  the  program  to  stop  with  error  messages.  Next,  enter  the  data 
file  name  when  asked,  and  answer  the  prompts  described  after  the  next 
paragraph. 

82.  Scales.  The  BORflAP  program  uses  map  scales  (e.g.,  1:10,000)  and  dis¬ 
plays  the  limiting  scales  of  the  data  to  be  plotted  to  stay  within  the  graphics 
screen  limits.  To  produce  a  true  scale  drawing  on  the  graphics  terminal  hard 
copy  machine,  entered  scales  are  multiplied  by  five  and  the  resulting  scales 
are  shown  at  the  top  of  the  plot.  For  example,  if  the  limiting  scales  for 

the  data  were  1:1,000  and  1:2,000  and  scales  of  1:2,000  were  selected  for  both 
coordinate  sets,  then  the  resulting  plot  would  have  scales  of  1:10,000.  Thus, 
to  obtain  an  engineer  scale  of  1  in.  =  1,000  ft  (1  in  =  12,000  in.)  for  this 
example,  scales  of  1:2,400  should  be  selected  to  produce  a  hard  copy  with 
scales  of  1:12,000.  Plots  directed  to  drum  plotter  are  drawn  to  the  user 
specified  scales.  In  the  above  example  the  drum  plot  would  be  drawn  accurately 
to  a  scale  of  1:2,400  (even  though  the  preview  plot  on  the  screen  would  be 
drawn  to  the  scale  of  1:12,0001. 

83.  Program  prompts.  The  program  prompts  and  their  results  are  described 
below. 

a.  DATA  FILE  NAME?  (ENTER  04  TO  KEEP  CURRENT  FILE) .  The  user 
should  enter  the  file  name  for  the  first  plot  and  can  then 
enter  04  for  other  plots  with  the  same  data  later  in  the 
session . 

DO  YOU  WANT  TO  LIST  04?  Entering  Y  produces  the  listing,  and 
N  causes  the  program  to  skip  to  the  next  prompt. 

£.  PLOT  TITLE?  The  plot  title  is  entered  (50-character  maximum) 
and  will  appear  across  the  top  of  the  plot. 


d.  BORING  DESCRIPTORS  TO  BE  PRINT0  ON  PLOT.  If  the  response 
is  Y,  the  plotted  points  will  he  numbered  (1,  2,  3,  etc.), 
and  a  table  of  these  numbers  and  corresponding  piezometer 
number^  will  he  included  on  the  right  side  of  the  plot.  If 
N  is  entered,  the  numbers  and  the  table  will  not  be  shown  on 
the  plot. 

e.  SCALirJG  OPTIONS,  ENTER  O-AUTO  1-SET  MANUALLY  2-USE  LAST 
SCALE.  Entering  0  results  in  automatic  grid  scaling  for  the 
limits  of  the  data.  Entering  1  allows  user  to  select  his  own 
grid  scale  limits  (minimum  of  500  ft  for  offset  and  1,000  ft 
for  station  grid  spacing).  Entering  2  specifies  that  the 
grid  scale  used  for  the  previous  plot  in  the  current  session 
be  used  for  the  next  plot. 

f.  no  YOU  WANT  THE  GRID  DRAWN?  (Y/N  OR  H  IF  YOU  WANT  THE  GRID 
TIC  LINES  BUT  NOT  LABELS).  Entering  Y  produces  a  complete 
grid  with  coordinate  labels  and  N  suppresses  the  grid  and 
labels.  Entering  H  produces  tic  lines  around  the  border  and 
at  grid  intersections  but  does  not  label  the  coordinates. 

a.  CHOOSE  VERT  SCALE  =1;  XXXX 

■“  CHOOSE  HORZ  SCALE  =1:  XXXX 

The  maximum  scale  values  for  the  data  to  fit  on  the  screen 
are  shown,  and  the  user  enters  desired  values  equal  to  or 
greater  than  those  shown  (e.g.,  2,400,  2,400  for  equal  verti¬ 
cal  and  horizontal  scales  to  produce  an  engineering  scale  of 
1  in.  =  1,000  ft,  i.e.  5  x  2,400  =  l;12,0b0).  If  1  is 
entered  in  prompt  e,,  prompt  £.  above  is  replaced  with  a  dis¬ 
play  of  the  maximum  and  minimum  values  of  the  x  and  y 
coordinates,  and  the  user  is  asked  to  enter  the  desired  values 
(e.g.,  622,500,  625,500,  1,601,000,  1,605,000). 

K  ARE  THE  GRAPHICS  TO  GO  TO  THE  DRUM  PLOTTER?  Y/N/M— (M  FOP 
MAYBE-GIVES  PREVIEW  ON  SCREEN).  After  entering  the  desired 
option,  the  following  message  appears: 

MAKE  COPY  ANO/OR  HIT  RETURN 

At  this  point  the  user  can  copy  the  screen  before  hitting 
the  return  key.  On  CDC  the  user  should  enter  a  number  (e.g., 
3)  before  hitting  the  return  key  (otherwise  the  program  may 
stop  with  a  series  of  error  messages).  Entering  Y  skips  the 
screen  plot  and  starts  drum  plots  queries.  A  reply  of  N 
produces  a  plot  on  the  screen  and  skips  the  drum  plot  option. 
Entering  M  produces  a  plot  with  options  to  send  it  to  the 
drum  plotter  after  review  or  to  start  a  new  plot.  After 
every  plot  is  finished,  the  terminal  beeps  to  allow  the  user 
to  copy  the  plot  before  hitting  the  return  key.  In  the  M 
option,  after  the  plot  is  copied  and  return  is  entered,  the 
user  is  asked  "TO  DRUM  NOW?"  If  the  reply  is  N,  new  plot 
queries  are  started.  If  the  reply  is  Y  on  CDC,  the  user  is 
asked  for  his  user  number.  When  the  user  number  is  entered, 
the  screen  should  be  copied  before  hitting  the  return  key 
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because  the  system  responds  that  TAPE999  is  the  plot  tape 
file,  and  the  screen  is  quickly  erased.  ^The  user  has  to 
contact  his  Anp  center  to  pull  his  plot  file  for  CDC  and 
plot  it.)  On  the  Honeywell  system,  the  user  is  asked  for 
his  identification  and  other  data  to  define  the  remote  site 
and  type  of  plot.  After  entering  the  type  of  plot  options, 
the  screen  should  be  copied,  since  a  snub  number  is  displayed 
and  the  screen  is  immediately  erased.  It  may  be  necessary 
for  the  user  to  contact  his  APP  center  to  pull  his  plot  file 
from  the  Division  Honeywell  system. 

84.  Examples.  Table  17  shows  examples  of  data  file  generation  and  use 
of  the  B0W1AP  program. 

Contouring 

85.  Capabil ities.  The  contouring  program,  BORCON,  for  piezometer  data 
can  produce  a  contour  plot  of  any  elevation  data.  The  program  is  the  same 
as  that  for  BORMAP  with  contouring  added.  The  contouring  option  was  adapted 
from  a  program  developed  by  Mr.  Fred  Tracy,  WESKS.  The  user  is  asked  for  the 
data  file  name  and  is  asked  questions  about  the  options  for  columns  to  plot, 
type  of  coordinates,  scale,  grid  display,  and  point  reference  number  or  symbol 
display.  Additional  prompts  ask  if  contouring  is  desired,  what  column  combi¬ 
nations  and  factor  (col  5  +/-  col  4  times  a  factor)  are  to  be  used  for  plotting, 
and  what  boundary  elevation  code  to  use  for  the  border  of  the  plot  to  prevent 
unrealistic  contours  at  the  limits  of  the  data.  A  piezometer  location  plot  is 
drawn  first,  and  then  contours  are  added.  The  program  does  not  provide  for 


blocking  out  of  interior  areas  where  contours  are  not  wanted.  For  example,  if 
piezometer  contours  were  drawn  for  an  area  with  a  high,  impervious  ridge  of 
rock  through  the  middle  of  an  area,  contours  for  water  table  elevations  would 
also  be  drawn  through  the  ridge.  One  way  to  overcome  this  problem  might  be  to 
outline  the  ridge  with  additional  data  points  of  the  same  elevation  that 
is  higher  than  any  adjacent  point  outside  the  ridge.  Contour  plots  can  be 
displayed  at  the  graphics  terminal  (Tektronix  or  equivalent),  or  directed  to  a 
flat  bed  plotter  to  produce  a  plot  to  a  desired  scale  for  use  as  an  overlay  on 
an  existing  map.  The  program  is  presently  only  available  on  the  Honeywell 
computer  systems.  Selection  and  use  of  scales  are  the  same  as  for  the 
BORMAP  program. 

86.  Data  files.  The  data  file  for  use  with  BORCON  must  be  generated  with 
the  LIST  command.  The  file  is  generated  in  the  same  manner  as  for  the  BORMAP 
program.  The  file  should  contain  the  elevation  data  needed  for  contouring. 
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BORCON  allows  the  use  of  a  contour  values  derived  from  any  column  plus  or  minus 
any  other  column  times  a  factor.  Data  files  already  generated  that  include 
desired  data  can  be  used,  since  the  program  displays  the  data  groups  and 
columns  for  selection  of  data  by  the  user. 

87.  Examples.  Table  18  shows  an  example  of  contouring  plots  on  the 
Honeywell  computer  system. 

General  X-Y  Plot 

88.  Capabilities.  This  plot  program  was  developed  to  plot  data  in  an 
x-y  format.  Any  data  file  that  contains  columns  of  values  can  be  plotted  with 
this  program.  To  generate  a  plot,  the  user  selects  options  from  the  menu 
listed  below: 

OPTION  _ DESCRIPTION _ 

1  NAME  INPUT  DATA  FILE 

2  READ  LABELS  FROM  FILE 

3  INPUT  LABELS  FROM  THE  TERMINAL 

4  STANDARD  SCALE 

5  INPUT  SCALE  FROM  THE  TERMINAL 

6  LINE  ADDED  TO  PLOT 

7  PLOT  DATA 

8  TERMINATE  PROGRAM  (STOP) 

Options  1  and  7  must  be  selected  to  generate  a  olot  along  with  either  option  4 
or  5.  If  titles  and  labels  are  reguired,  then  options  2  or  3  must  be  selected. 
The  options  can  be  selected  one  by  one  or  several  at  a  time.  In  addition  to 
selecting  the  data  file  name,  the  first  option  determines  which  data  will  be 
plotted.  This  option  will  print  the  data  file  line  by  line  until  the  user 
indicates  that  the  first  line  of  the  x-axis  data  has  been  encountered.  At  this 
point,  the  user  is  asked  for  the  column  number  at  the  beginning  of  the  data 
along  with  the  size  of  the  data.  The  user  then  indicates  how  many  curves  will 
be  plotted  along  the  x-axis.  The  y-axis  data,  which  could  be  located  in  a 
different  data  file  than  the  x-axis,  is  then  located  by  the  same  method  that 
for  the  x-axis  data.  By  using  this  method,  data  that  are  located  in  various 
columns  can  be  selected  (i.e.,  plot  data  in  column  6  versus  column  2).  The 
last  question  this  option  asks  the  user  is  whether  the  data  points  should  be 
connected  with  a  line.  Both  the  second  and  third  options  will  read  three 
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lines  of  data  up  to  23  characters  each  for  the  title  and  x  and  y  axis 
labels.  The  second  option  will  read  from  a  user-specified  data  file,  while  the 
third  option  will  prompt  the  user  for  the  infomation.  The  standard  scale, 
option  4,  will  use  the  minimum  data  value  to  establish  the  lower  end  of  the 
scale  and  then  increment  the  scale  by  an  interval  which  is  determined  from  the 
range  of  the  data.  If  the  user  does  not  like  the  standard  scale,  option  5  can 
be  used  to  set  the  scale.  This  option  can  be  used  to  window  in  on  a  portion 
of  the  data.  Option  6  allows  up  to  four  lines  to  be  added  to  the  plot  (i.e., 

45  deg  line,  or  vertical  and  horizontal  specification  boundaries).  The  last 
two  options  are  self-explanatory.  Once  the  data  have  been  defined,  the  user 
can  go  through  the  options  in  any  order.  Thus,  an  initial  plot  with  the 
standard  scale  could  be  generated;  then  the  user  could  modify  the  scale,  add 
lines,  and  replot. 

89.  The  data  files  for  use  with  this  plot  program  can  contain  any 
number  of  data  columns  and  heading  information.  These  files  will  usually  be 
generated  in  the  data  base  by  using  the  REPORT  FILE  and  LIST  commands.  The 
only  data  restriction  for  this  plot  program  is  that  only  numeric  values  can 
be  plotted. 

90.  Plot  execution.  The  following  command  will  execute  the  x-y  plot 
program. 

BEGIN,  ,r.ENXY 

91.  Example.  Table  19  shows  an  example  of  the  use  of  the  x-y  plot 
program.  This  example  illustrates  the  use  of  one  data  file  to  generate  a  plot 
and  the  use  of  two  separate  data  files  to  generate  the  same  plot. 
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INPUT  STARTING  COLUMN  FOR 


INPUT  TITLE  (23  CHARACTERS  MAX) 
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GENERALIZED  XV  PLOT 


UOULD  VOU  LIKE  TO  SELECT  SEUERAL  OPTIONS  AT 
ONE  TINE  (Y/N) 


MULTIPLE  OPTIOMS  ARE  SELECTED 

TO  EXIT,  MOUE  THE  CROSSHAIRS  ABOUE  BOX  8 

AND  ENTER  A  CARRIAGE  RETURN  ONLY 


NUMBER  OF  LINES  TO  BE  ADDED  (4  MAX 


GENERALIZED  XV  PLOT 
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NAME  OF  DATA  FILE 
><DATA 

DATE  POOL 
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1.  Two  procedures  are  available  to  back  up  or  copy  the  data  base  for 
reloading  in  case  the  data  base  is  damaged.  The  first  procedure  creates  a 
permanent  report  file  of  the  data  in  the  data  base  and  the  second  automatically 
creates  a  binary  file  when  data  is  loaded  to  the  data  base  using  "UPDPIZB" 
(batch  load  command  file).  The  two  procedures  are  described  below. 

Report  File  Back  Up 

2.  Enter  the  data  base  mode  on  CDC  by  typing  in  -GETDB.  After  entry  to 
the  data  base  mode,  type  the  following  commands. 

USER,XXX;DBN  IS  PIEZOB;  (XXX  is  the  user  password) 

REPORT  FILE  IS  PIEZSV;  (or  other  file  name) 

UNLOAD  BY  C0,C0  WH  Cl  EXISTS  OR  Cl  FAILS; 

(to  ensure  all  data  with  or  without  Cl  values  are  unloaded) 

EXIT; 

After  exiting  the  data  base  mode,  save  the  report  file. 

SAVE, PIEZSV 

If  the  data  base  is  damaged  later,  the  data  can  be  reloaded  from  the  permanent 
file  PIEZSV.  However,  any  data  loaded  after  saving  PIEZSV  would  be  lost.  To 
reload  the  data  base,  the  user's  data  base  administrator  should  be  contacted. 
The  advantage  of  this  procedure  is  that  the  report  file  can  be  saved  on  a  re¬ 
claim  tape  to  reduce  storage  costs. 


Batch  Binary  Back  Up 

3,  The  automatic  back  up  on  a  binary  file  uses  procedures  in  the  UPDPIZB 
file  to  create  a  TAPE99R  local  file  that  is  saved  to  a  permanent  file  called 
PIZTAPE.  A  copy  of  the  file  UPDPIZB  is  listed  below. 

.PROC, UPDPIZB, DATPIZ. 

SUBMIT,JOBFIL,N. 

SREVERT. 

.DAT A, JOB FI L. 

/JOB 

JOB,CM200nO0,T2O00,P5. 

/USER. 

/CHARGE. 

MAP, OFF. 

GET,SUMPIZ. 

GET,S2KGET/UN=CECE2K. 

GET,DRVPIZ/UN=CER0K2. 

GET, DATPIZ. 

GET,PI7M0DU/UN=CER0K2. 


PIZMODU. 

REPLACE, SUMPIZ. 

ATTACH ,S2K/UN=CECE2K. 

S2K,C=INPUT,M=DUMMY,TP. 

RENAME, PIZTAPE=TAPE999. 

REPLACE, PIZTAPE. 

RETURN ,TAPE999. 

REPLACE ,OUTPUT=PIZDAY. 

REPLACE, DUMMY. 

RETURN, A ,S2K. 

EXIT. 

DAYFILE.ERRLIST. 

SAVE, ERRL 1ST. 

/EDR 

USER,nLW;OBN  IS  PIEZDB; 

CONTROL; 

ECHO  ON; 

REWIND  TAPE999; 

SAVE  DATA  BASE  ON  TAPE999; 

EXIT; 

/EOF 

An  alternative  is  to  save  the  data  base  while  in  the  data  base  with  the  follow¬ 
ing  connands.  System  2000  must  be  called  using  the  TP  option  as  done  in 
procedure  file  DBSAVE. 

CONTROL; 

SAVE  DATA  BASE  ON  TAPE999; 

EXIT; 

After  exiting  the  data  base,  save  the  local  file  TAPE999  to  the  desired  file 
name. 


SAVE,TAPE999 
RENAME, P I ZTAPE=TAPE999 

To  reload  a  damaged  data  base,  the  data  base  administrator  should  be  contacted. 
The  saved  data  file  cannot  be  stored  on  a  reclaim  tape.  However,  it  requires 
less  disk  storage  space  than  the  report  file  back  up  and  is  less  costly  to 
store  on  line. 


Editing  Files  on  CDC 


1,  Instructions  for  use  of  the  Corps  of  Engineers  editor  or  the  NOS 
XEDIT  utilities  on  CEO  are  described  below. 

The  NOS  system  XEDIT  (see  Cybernet  Services,  NOS  XEDIT,  Extended 
Text  Editor,  Reference  Card,  Publication  No.  84000  680). 
Instructions  can  be  obtained  by  entering  the  following  command. 

EXPLAIN, XEDIT 

The  version  of  COED  IT  on  CDC  is  available  during  field  test 
period  until  installation  of  the  final  version  about  1  November 
1985.  Information  on  use  of  COEDIT  is  obtained  with  the  follow¬ 
ing  commands. 

/GET,COEDIT/IJN=LIBRARY 

/COEDIT, DUMMY 

E  > HELP, STATUS 

(to  exit  from  COEDIT,  type  OUIT) 

Editing  Files  on  the  Harris  Computer 

2.  On  the  Harris  computer,  enter  the  following  command  to  obtain  in¬ 
structions  for  the  Corps  of  Engineers  editor  (COED). 
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